|
9171
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9171
|
|
9170
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
PhostormVIewINavigareCodeLaravelKeractorFV faVsco.js?9 master kProiect vm ServiceTraits© DataClient.php© DecorateActivity.php• Locdisearch.onpo kemotesearen.ong© Service.phpv @ Listeners© ConvertLeadActivitieC Purgelookupcacne..0 Metadata>- Migrationu Pipedriveu salestorceW Fields> OpportunitvMatchenOpportunitvSvncStra> ProspectSearchStratM Service Traits(c) clientoho© DecorateActivitv.ohr() DeleteObiectsTrait.ol 22:C) FieldDefinitions.onv© PayloadBuilder.php© Profile.php© QueryBuilder.php© QueryHandler.php© Querylterator.php© QueryResults.php© Service.php© SyncBatchRedisServTm Traite232© BaseClient.php© BaseService.php© CachedCrmServiceDecc 249© CountryCodeResolver.pl 257CrmActivitvProviderIntec) crmactivityService.php© CrmConfigurationSettine© CrmObiectsResolver.phi 200c) DeraultProsoectSearchsc) Email-eloer.oho2621)FindsProspectinterface.C) LavoutManager.oho@ MatchDomainRvEmaillnt 282@ OpnortunitvActivitvMatc 285(1) OnportunitvSvncStratea(c) OnnortunitvSvneStrateo(c) Procnectcache nhn8 ProsnentSearchSconen© ProspectSearchStrategy 324AskJiminnyReportActivityServiceTest vJiminnyDebugcommano.org© CheckAndRetryRemoteMatch.php© MatchActivityCrmData.phpn. DeleteCrmEntityraic.ongo kematcnactiviyoncrmobjectbetach.org© CrmActivityService.php© CrmObjectsResolver.phpclass Prospectcachepublic function fand prospectidentifierreturn Sresult.public function findDomainMatch(Configuration Sconfiguration, string $identifier, ?int SuserId = null): ?arral?public function set(Configuration Sconfiguration, string $identifier, array $prospectData, ?int SuserId = nul13public function handleProspectUpdated(ProspectUpdated Sevent): void{...}public function normalizePhoneNumber(string Sphone): string{...}private function get(Confiquration Sconfiquration,string Sidentifier, ?int SuserId = null): ?arrayreturn Sthis-›cache->tags(Sthis->qetTaqs(Sconfiquration. Sidentifier))-›aet Sthis->generatekey Sconfiauration. Stdentifier. Suserid)):4 SF jiminny@localhost]A HS_local [jiminny@localhost]A console [PKol)A console [EU]A console [STAGING][2026-05-07 14:21:15] local.INF0: [Hubspot] DEBUG Getting headers {M X19 A V"neaders".?"Uace".L"Inu,or May 2020 14.21.15 6Ml"Jn"concenc-lyoe. apolicacionison.charser=uct-o.n"Transter-Encodinq":"chunked")n"CF-Ray":"9t80deb8dbo0dcsa-S0F""Strict-Transport-Secur1ty":"max-aqe=31536008* 1ncLudeSubDomains: preload"),acceot-encodino""server-timing": ["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\","x-content-type-options": ["nosniff"],"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],"Set-Cookie":["__cf_bm=StUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxT07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Renont-To".f"y"endnoints".\"url\":\"https:|\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgl\"group\":\"cf-nel\".\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,reportto. "cr-nel"max age| ":604800}"]."Server": ["cloudflare"]}} {"correlation_1d": "95256555-ec98-4541-D92a-adta/Sboyead","trace_10":C/AD8565-905t-4604-9405-0e5b551e55455CascadeHubspot Rate LimitingHubSpot Rate Limit ReexploringwInvestigating Rate L100% LzFri 8 May 15:15:19+0 ..hp#L56-74 it would still cache byprivate function generateKev(Configuration Sconfiquration, string Sidentifier. ?int SuserId = null): string{.27orivate function sendDatadogStats(strina Sresult, strina Sermì• voidk...?Tusageprivate function getCacheTtl: intt...}nnivate function findinnontunitvInContac+Rolec(Confiaunation Sconfiaunationl?Profile Sprofileint Scontac+td): ?Opportunity {...}private function getOpportunityFromDatabase(contquraron scontzqurarzon.Account Saccount.int Scontactid.Pint SuserId = null): 20pportunity {...}Aol anuthinn 190 Al+ «> Codec Adantive• 0W Windsurf Toams222•6/267 charc Aline hreakc) UTF.8 #l A enacoe...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9170
|
|
9169
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9169
|
|
9168
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9168
|
|
9167
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9167
|
|
9166
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9166
|
|
9165
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9165
|
|
9164
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9164
|
|
9163
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
SlackFileEditViewGoHistoryWindowHelp> 0 lbl• Support Daily • 2 m leftAPP (-zsh)DOCKERDEV (docker)882APP (-zsh)883-zsh• 84PHPruntime:8.3.30Running analysis on 7 cores with 10 files per process.Parallel runner is an experimental feature and may be unstable, use it at your own risk. Feedback highly appreciated!Loadedconfig default from".php-cs-fixer.dist.php"5663/5663100%screenpipe"Fixed 0 of 5663 files in 42.875 seconds, 60.00 MB memory usedWhat's next:Try Docker Debug for seamless, persistent debugging tools in any container or image → docker debug docker_lamp_1Learn moreat [URL_WITH_CREDENTIALS] ~/jiminny/app (master) $ git pullremote: Enumerating objects: 15,done.remote: Counting objects: 100% (15/15), done.remote: Compressing objects: 100% (2/2), done.remote: Total 15 (delta 13), reused 15 (delta 13), pack-reused 0 (from 0)Unpacking objects: 100% (15/15), 1.28 KiB | 72.00 KiB/s, done.From github.com:jiminny/appc57e71e763..8743fea32e* [new branch]Already up to date.lukas@Lukas-Kovaliks-MacBook-Pro-Jiminny ~/jiminny/app (master) $JY-20606-desktop-app-recall-> origin/JY-20606-desktop-app-recallJY-20819-increase-download-transctip-rate-limit -> origin/JY-20819-increase-download-transctip-rate-limit100% C8Fri 8 May 15:13:02•$5-zsh₴6APP...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9163
|
|
9162
|
Project: faVsco.js, menu
master, menu
PhostormVIew Project: faVsco.js, menu
master, menu
PhostormVIewINavigareCodeLaravelKeractorFV faVsco.js?9 masterProiect•JiminnyDebugcommand.ongm ServiceTraitsn. DeleteCrmEntityraic.ongo kematcnactiviyoncrmobjectbetach.org© CheckAndRetryRemoteMatch.php(C) MatchActivityCrmData.ong© DataClient.php© DecorateActivity.php(c) LocalSearch.onp© CrmObjectsResolver.phpo kemotesearen.ong© Service.phpv @ Listeners© ConvertLeadActivitieC Purgelookupcacne..0 Metadata>- Migrationu Pipedriveu salestorceW Fields> OpportunitvMatchenOpportunitvSvncStra> ProspectSearchStratM Service Traitsc) clientoho© DecorateActivitv.ohr() DeleteObiectsTrait.ol 22:C) FieldDefinitions.onv230© PayloadBuilder.php© Profile.php© QueryBuilder.php@ QuervHandler.php© Querylterator.php@ QuervResults.php© Service.php© SyncBatchRedisServTm Traite232© BaseClient.php© BaseService.php© CachedCrmServiceDecc 249© CountryCodeResolver.pl 257CrmActivitvProviderinte© CrmActivityService.php© CrmConfigurationSettin© CrmObiectsResolver.phi 260© DefaultProspectSearchs262c) Email-eloer.oho@ FindsProspectinterface, 281C) LavoutManager.oho(1) MatchDomain3vEmailint@ OpnortunitvActivitvMatc(1) OnportunitvSvncStratea(c) Procnectcache nhn8 ProsnentSearchSconen© ProspectSearchStrategy 324class Prospectcachepublic function fand prospectidentifierreturn Sresult.public function findDomainMatch(Configuration Sconfiguration, string $identifier, ?int SuserId = null): ?arral?public function set(Configuration Sconfiguration, string $identifier, array $prospectData, ?int SuserId = nuz13public function handleProspectUpdated(ProspectUpdated Sevent): void{...}public function normalizePhoneNumber(string $phone): string{...}frivate funetion gettconfaguration Sconfiguration, Sträng Sidentifien, Pänt SuseniG E nUlL): Forrareturn $this->cache->tags($this->getTags($configuration, $identifier))-›aet Sthis->generatekeyconfiquration.Sidentifier. Suserid)):private function generateKev(Configuration Sconfiquration, string Sidentifier. ?int SuserId = null): string{.27onivate function sendDatadoaStats(strina Sresult. string Scrm)• void!...?1 usageprivate function getCacheTtl: intf...}nnivate function findûnnontunitvTnContactRolec(Confiaunation Sconfiaunationl?Profile Sprofileint Scontac+td): ?Opportunity {...}private function getOpportunityFromDatabase(contquraron scontzqurarzon.Aosount Saccount.int Scontactid.Pint SuserId = nuli): 20pportunity {...}suppont Dally • 2m len100% 12Fri 8 May 15:13:01AskJiminnyReportActivityServiceTest v+0 ..4 SF jiminny@localhost]A HS_local [jiminny@localhost]# console [PKol)A console [EU]A console [STAGING][2026-05-07 14:21:15] local.INF0: [Hubspot] DEBUG Getting headers {"neaders".?"Uace"."Inu,or May 2020 14.21.15 6Ml"Jn"concenc-lyoe. apolicacionison.charser=uct-o.n"Transter-Encodinq":"chunked")n"CF-Ray":"9t80deb8dbo0dcsa-S0F""Strict-Transport-Secur1ty":"max-aqe=31536008* 1ncLudeSubDomains: preload"),M X19 A V"server-timing": ["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\","x-content-type-options": ["nosniff"],"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],"Set-Cookie":["__cf_bm=StUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxT07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Renont-To".f"y"endnoints".\"url\":\"https:|\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgl\"group\":\"cf-nel\".\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,reportco. "cr-nel,"max age| ":604800}"]."Server": ["cloudflare"]}} {"correlation_1d": "95256555-ec98-4541-D92a-adta/Sboyead","trace_10":C/AD8565-905t-4604-9405-0e5b551e55455CascadeHubspot Rate LimitingHubSpot Rate Limit ReInvestigating Rate LinThere is no cache laver at the decorator level Tor name matching — it delegates straight to the service4. getPaginatedData fetches ALL pagesmatchByName calls getPaginatedData() (not the generator) which eagerly fetches all pages of contact results. generateSearchContactsByNamePayload uses CONTAINS TOKEN which can match many contacts — every page is a separate APl request.5. usleep($delay) is per-job, not per-team• HubspotPaginationService.php:39poelay = schis-catcularevelay.nmacrosecongs.g• PaginationConfig.php:10public const int SEARCH_RPS LIMIT = 4;Ine delay is 1/4 * 1,000,000 = 250ms per request per job instance • With N Jobs running in parallel, the enfective rate is 4 * N Rps TromHubSpot's perspective. HubSnot's search endooint limit is 5 RPS alobally per portal _ with iust 2 concurrent iobs the limit is already blownSummarv of Root CausesImpactNo rate limitina coordination across iobsMultiole workers hit HubSoot simultaneouslv. multiolvina RPSmatchßvName has no decorator-level cacheSame name searched repeatedly by different jobsmatchßvName cache TiLis onlv 60s, scoved to userldCache busts trequentiv. same contact name searched N timecgetPaginatedData fetches all pages eagerlyoportunities chained APl calOne participant match = 2+ paginated searchesN activities dispatched = N independent concurrent iobsSuggested ImprovementsImmediate " Hiah moact1.Add decorator-level cachina.for.matchBvvame.in.cachedcimServicedecorator-scope.the cache.kev toconfiald_+namenot usenid withalonger iL.e.g.omin. contact names con u change per-user2. Use the generator instead of getPaginatedData in matchBvName — stoo after first result with →current() , don't fetch all pages.3. Implement a team-scoped Redis rate limiter (e.g. sliding window) in HubspotPaginationService:: executeSearchRequest() to enforce ≤5RPS across all workers for the same portalA Catch GuzzleHttnl Eycention\ClientFycention with 120 and imnlement eynonential backoff — currentlv the eycention oronadates unhandledand the iob retries after (30. 98. 180] seconds, but the root cause (other jobs) is still running.5. Increase matchByName cache TTL and remove userId from cache key — a contact named "John Smith" is the same regardless of which repsearched for them.wif we would place matchByName to CachedCrmServiceDecorator same as @CachedCrmServiceDecorator.php#L56-74 it would still cache byC° AdantiveWN Windsurf Teams 222•6 UTF.8io 4 spaces...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9162
|
|
9161
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9161
|
|
9160
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9160
|
|
9159
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9159
|
|
9158
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9158
|
|
9157
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
8
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Jiminny\Contracts\Services\Crm\ConnectionStateInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesWithCacheInterface;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\ApplicationException;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Psr\Log\LoggerInterface;
class CachedCrmServiceDecorator implements MatchCrmEntitiesWithCacheInterface
{
private ?ServiceInterface $crmService = null;
private ProspectCache $prospectCache;
private LoggerInterface $logger;
private ?Configuration $configuration;
public function __construct(
ProspectCache $prospectCache,
LoggerInterface $logger
) {
$this->prospectCache = $prospectCache;
$this->logger = $logger;
$this->configuration = null;
}
public function setCrmService(?ServiceInterface $crmService = null): void
{
$this->crmService = $crmService;
}
public function setConfiguration(Configuration $configuration): void
{
$this->configuration = $configuration;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
if (! filter_var($email, FILTER_VALIDATE_EMAIL)) {
$this->logger->warning('[Prospect match] Invalid email address', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_EMAIL,
'identifier' => $email,
]);
// The email address of the prospect is invalid.
// Return null, so we can try to match by phone or name.
return null;
}
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_EMAIL,
identifierValue: $email,
userId: $userId
);
}
public function matchByDomain(string $email, ?int $userId = null): ?array
{
if (! $this->crmService instanceof MatchDomainByEmailInterface) {
$this->logger->info('[Prospect match] Service does not support matching by domain', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'crm' => $this->crmService?->getDisplayName() ?? 'Not set',
'email' => $email,
]);
return null;
}
$domain = $this->crmService->getDomain($email);
if (empty($domain)) {
$this->logger->info('[Prospect match] Empty domain name', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'email' => $email,
]);
return null;
}
$this->logger->info('[Prospect match] Resolved company domain from email', [
'email' => $email,
'domain' => $domain,
]);
$configuration = $this->getConfiguration();
// try the cache
$cachedValue = $this->prospectCache->findDomainMatch(
configuration: $configuration,
identifier: $domain,
userId: $userId
);
if ($cachedValue !== null) {
return $cachedValue;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]);
$apiResult = $this->crmService->matchByDomain(domain: $domain, userId: $userId);
if (empty($apiResult)) {
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]
);
// cache the miss with empty prospect data
$apiResult = [null, null, null, null, null, null];
}
$this->prospectCache->set(
configuration: $configuration,
identifier: $domain,
prospectData: $apiResult,
userId: $userId
);
return $apiResult;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => 'name',
'identifier' => $name,
]);
return null;
}
return $this->crmService->matchByName(
name: $name,
userId: $userId
);
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_PHONE,
identifierValue: $phone,
identifierSecondaryValue: $rawPhoneNumber,
userId: $userId
);
}
/**
* @throws ApplicationException
*/
private function matchByProspectIdentifier(
string $identifierType,
string $identifierValue,
?string $identifierSecondaryValue = null,
?int $userId = null,
): ?array {
$configuration = $this->getConfiguration();
$profile = $this->crmService->profile ?? null;
// Normalize phone number BEFORE cache lookup
if ($identifierType === ProspectCache::PROSPECT_TYPE_PHONE) {
$identifierValue = $this->prospectCache->normalizePhoneNumber($identifierValue);
}
$prospectData = $this->prospectCache->findByProspectIdentifier(
configuration: $configuration,
profile: $profile,
identifierType: $identifierType,
identifierValue: $identifierValue,
userId: $userId,
crmService: $this->crmService
);
if ($prospectData !== null) {
$this->logger->info('[Prospect match] Cache / local search hit', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (empty(array_filter($prospectData))) {
$this->logger->info('[Prospect match] cached empty result - no API calls, try next matching method', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
/**
* @IMPORTANT This is a cached empty result, i.e. there's no prospect with this email.
* We cache the empty result, so we don't keep querying the database and the API
* for non-existing prospects.
* However, we need to return null from this method
* in order to trigger the next matching method (e.g. matchByPhone or matchByName).
* This is because an array with null values is not considered empty.
*/
return null;
}
return $prospectData;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
return null;
}
/** @var 'email'|'phone' $identifierType */
$apiResult = match($identifierType) {
ProspectCache::PROSPECT_TYPE_EMAIL => $this->crmService->matchExactlyByEmail(
email: $identifierValue,
userId: $userId
),
ProspectCache::PROSPECT_TYPE_PHONE => $this->crmService->matchByPhone(
phone: $identifierValue,
rawPhoneNumber: $identifierSecondaryValue,
userId: $userId
),
};
$cachedResult = $apiResult;
if (empty($apiResult)) {
// In case the result is null or an empty array,
// cache the missing prospect, so we don't keep calling the API
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]
);
$cachedResult = [null, null, null, null, null, null];
}
// Set the cache even if the result is empty,
// so we don't keep querying the database and the API
$this->prospectCache->set($configuration, $identifierValue, $cachedResult, $userId);
return $apiResult;
}
private function isConnected(): bool
{
if ($this->crmService instanceof ConnectionStateInterface) {
return $this->crmService->isConnected();
}
return $this->crmService !== null;
}
/**
* @throws ApplicationException
*/
private function getConfiguration(): Configuration
{
if ($this->configuration) {
return $this->configuration;
}
if ($this->crmService?->getConfiguration()) {
return $this->crmService->getConfiguration();
}
throw new ApplicationException('Missing team configuration. Cannot set team prospect cache');
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9157
|
|
9156
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
8
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Jiminny\Contracts\Services\Crm\ConnectionStateInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesWithCacheInterface;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\ApplicationException;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Psr\Log\LoggerInterface;
class CachedCrmServiceDecorator implements MatchCrmEntitiesWithCacheInterface
{
private ?ServiceInterface $crmService = null;
private ProspectCache $prospectCache;
private LoggerInterface $logger;
private ?Configuration $configuration;
public function __construct(
ProspectCache $prospectCache,
LoggerInterface $logger
) {
$this->prospectCache = $prospectCache;
$this->logger = $logger;
$this->configuration = null;
}
public function setCrmService(?ServiceInterface $crmService = null): void
{
$this->crmService = $crmService;
}
public function setConfiguration(Configuration $configuration): void
{
$this->configuration = $configuration;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
if (! filter_var($email, FILTER_VALIDATE_EMAIL)) {
$this->logger->warning('[Prospect match] Invalid email address', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_EMAIL,
'identifier' => $email,
]);
// The email address of the prospect is invalid.
// Return null, so we can try to match by phone or name.
return null;
}
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_EMAIL,
identifierValue: $email,
userId: $userId
);
}
public function matchByDomain(string $email, ?int $userId = null): ?array
{
if (! $this->crmService instanceof MatchDomainByEmailInterface) {
$this->logger->info('[Prospect match] Service does not support matching by domain', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'crm' => $this->crmService?->getDisplayName() ?? 'Not set',
'email' => $email,
]);
return null;
}
$domain = $this->crmService->getDomain($email);
if (empty($domain)) {
$this->logger->info('[Prospect match] Empty domain name', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'email' => $email,
]);
return null;
}
$this->logger->info('[Prospect match] Resolved company domain from email', [
'email' => $email,
'domain' => $domain,
]);
$configuration = $this->getConfiguration();
// try the cache
$cachedValue = $this->prospectCache->findDomainMatch(
configuration: $configuration,
identifier: $domain,
userId: $userId
);
if ($cachedValue !== null) {
return $cachedValue;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]);
$apiResult = $this->crmService->matchByDomain(domain: $domain, userId: $userId);
if (empty($apiResult)) {
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]
);
// cache the miss with empty prospect data
$apiResult = [null, null, null, null, null, null];
}
$this->prospectCache->set(
configuration: $configuration,
identifier: $domain,
prospectData: $apiResult,
userId: $userId
);
return $apiResult;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => 'name',
'identifier' => $name,
]);
return null;
}
return $this->crmService->matchByName(
name: $name,
userId: $userId
);
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_PHONE,
identifierValue: $phone,
identifierSecondaryValue: $rawPhoneNumber,
userId: $userId
);
}
/**
* @throws ApplicationException
*/
private function matchByProspectIdentifier(
string $identifierType,
string $identifierValue,
?string $identifierSecondaryValue = null,
?int $userId = null,
): ?array {
$configuration = $this->getConfiguration();
$profile = $this->crmService->profile ?? null;
// Normalize phone number BEFORE cache lookup
if ($identifierType === ProspectCache::PROSPECT_TYPE_PHONE) {
$identifierValue = $this->prospectCache->normalizePhoneNumber($identifierValue);
}
$prospectData = $this->prospectCache->findByProspectIdentifier(
configuration: $configuration,
profile: $profile,
identifierType: $identifierType,
identifierValue: $identifierValue,
userId: $userId,
crmService: $this->crmService
);
if ($prospectData !== null) {
$this->logger->info('[Prospect match] Cache / local search hit', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (empty(array_filter($prospectData))) {
$this->logger->info('[Prospect match] cached empty result - no API calls, try next matching method', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
/**
* @IMPORTANT This is a cached empty result, i.e. there's no prospect with this email.
* We cache the empty result, so we don't keep querying the database and the API
* for non-existing prospects.
* However, we need to return null from this method
* in order to trigger the next matching method (e.g. matchByPhone or matchByName).
* This is because an array with null values is not considered empty.
*/
return null;
}
return $prospectData;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
return null;
}
/** @var 'email'|'phone' $identifierType */
$apiResult = match($identifierType) {
ProspectCache::PROSPECT_TYPE_EMAIL => $this->crmService->matchExactlyByEmail(
email: $identifierValue,
userId: $userId
),
ProspectCache::PROSPECT_TYPE_PHONE => $this->crmService->matchByPhone(
phone: $identifierValue,
rawPhoneNumber: $identifierSecondaryValue,
userId: $userId
),
};
$cachedResult = $apiResult;
if (empty($apiResult)) {
// In case the result is null or an empty array,
// cache the missing prospect, so we don't keep calling the API
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]
);
$cachedResult = [null, null, null, null, null, null];
}
// Set the cache even if the result is empty,
// so we don't keep querying the database and the API
$this->prospectCache->set($configuration, $identifierValue, $cachedResult, $userId);
return $apiResult;
}
private function isConnected(): bool
{
if ($this->crmService instanceof ConnectionStateInterface) {
return $this->crmService->isConnected();
}
return $this->crmService !== null;
}
/**
* @throws ApplicationException
*/
private function getConfiguration(): Configuration
{
if ($this->configuration) {
return $this->configuration;
}
if ($this->crmService?->getConfiguration()) {
return $this->crmService->getConfiguration();
}
throw new ApplicationException('Missing team configuration. Cannot set team prospect cache');
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9156
|
|
9155
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9155
|
|
9154
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
1
5
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Illuminate\Support\Collection;
use Jiminny\Contracts\Repositories\TeamRepository;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\InvalidArgumentException;
use Jiminny\Exceptions\SocialAccountTokenInvalidException;
use Jiminny\Models\Account;
use Jiminny\Models\Activity;
use Jiminny\Models\Contact;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Participant;
use Jiminny\Models\Stage;
use Jiminny\Models\Team;
use Jiminny\Models\User;
use Jiminny\Services\ResolveTeamCrmConnection;
use Psr\Container\ContainerExceptionInterface;
use Psr\Container\NotFoundExceptionInterface;
use Psr\Log\LoggerInterface;
use Exception;
use Throwable;
class CrmActivityService
{
public function __construct(
private readonly TeamRepository $teamRepository,
private readonly CachedCrmServiceDecorator $decorator,
private readonly EmailHelper $emailHelper,
private readonly ResolveTeamCrmConnection $teamCrmResolver,
private readonly LoggerInterface $logger,
) {
}
/**
* Updates CRM data for an activity and its participants.
*
* NOTE: This method performs multiple database writes and should be called
* within a transaction by the caller to ensure atomicity.
*
* @param Activity $activity
* @param bool $remoteSearch
*
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
* @throws Exception
*/
public function updateCrmData(
Activity $activity,
bool $remoteSearch = false,
): void {
$crmService = null;
$participants = $activity->getParticipants();
$team = $activity->getTeam();
$prospectSearchStrategy = ProspectSearchStrategyFactory::match($team);
if ($prospectSearchStrategy->ignoreCrmMatchData()) {
$this->logger->info('[CrmActivityService] Ignoring crm data because of prospect strategy', [
'activity_id' => $activity->getId(),
'strategy' => get_class($prospectSearchStrategy),
]);
return;
}
if ($remoteSearch) {
try {
$crmService = $this->teamCrmResolver->resolveForTeam($team);
} catch (SocialAccountTokenInvalidException) {
$this->logger->warning('[CrmActivityService] CRM token expired, falling back to local search', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
]);
}
}
$records = $this->updateParticipantsCrmData(
team: $team,
activity: $activity,
participants: $participants,
crmService: $crmService,
);
if (! empty($records)) {
$activity->updateActivityCrmData($records);
}
$activity->refresh();
}
/**
* @param Collection<Participant> $participants
*
* @throws Exception
*
* @return array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}|array{}
*/
private function updateParticipantsCrmData(
Team $team,
Activity $activity,
Collection $participants,
?ServiceInterface $crmService = null,
): array {
$matchedRecords = [];
$matchedDomainRecords = [];
$this->validateCrmConfiguration($activity);
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
foreach ($participants as $participant) {
if ($this->shouldSkipParticipant($participant)) {
continue;
}
if (! $this->shouldPerformLookup($participant, $team)) {
$this->logger->info('[CrmActivityService] Email domain belongs to the team, skipping crm lookup', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
'email' => $participant->getEmailAddress(),
]);
$this->attachUserIfExists($participant, $team);
continue;
}
$records = $this->findCrmRecords($participant, $activity);
if (! empty($records)) {
$matchedRecords[] = $records;
} else {
$records = $this->findCrmDomainRecords(
crmService: $crmService,
participant: $participant,
activity: $activity,
);
if (! empty($records)) {
$matchedDomainRecords[] = $records;
}
}
if (empty($records)) {
continue;
}
try {
$activity->updateParticipantCrmData($records, $participant);
} catch (Throwable $ex) {
$this->logger->error('[CrmActivityService] Failed to update participant CRM data', [
'activity_id' => $activity->getId(),
'participant_id' => $participant->getId(),
'exception' => $ex->getMessage(),
]);
continue;
}
}
$bestMatch = $this->getBestMatch(
matchedRecords : $matchedRecords,
matchedDomainRecords: $matchedDomainRecords,
);
$this->logger->info('[CrmActivityService] CRM matching completed', [
'activity_id' => $activity->getId(),
'participants_processed' => $participants->count(),
'exact_matches' => count($matchedRecords),
'domain_matches' => count($matchedDomainRecords),
'best_match_found' => ! empty($bestMatch),
]);
return $bestMatch;
}
private function shouldPerformLookup(Participant $participant, Team $team): bool
{
if ($participant->hasEmailAddress()) {
return $this->emailHelper->shouldPerformLookup($team, $participant->getEmailAddress());
}
return true;
}
private function validateCrmConfiguration(Activity $activity): void
{
if ($activity->getCrm() === null) {
throw new InvalidArgumentException('Cannot find CRM configuration');
}
}
private function getBestMatch(?array $matchedRecords, ?array $matchedDomainRecords): array
{
return RecordSelector::pickBestFromLists($matchedRecords, $matchedDomainRecords);
}
private function findCrmRecords(Participant $participant, Activity $activity): ?array
{
$records = null;
if ($participant->hasEmailAddress()) {
$records = $this->decorator->matchExactlyByEmail(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
}
if (empty($records) && $participant->getPhoneNumber() !== null) {
$records = $this->decorator->matchByPhone(
phone: $participant->getPhoneNumber(),
userId: $activity->getUser()->getId(),
);
}
if (empty($records) && $participant->getName() !== null) {
$records = $this->decorator->matchByName(
name: $participant->getName(),
userId: $activity->getUser()->getId(),
);
}
return $records;
}
private function shouldSkipParticipant(Participant $participant): bool
{
return $participant->hasUser();
}
private function attachUserIfExists(Participant $participant, Team $team): void
{
if ($participant->hasEmailAddress() === false) {
return;
}
$user = $this->teamRepository->findActiveTeamMemberByEmail($team, $participant->getEmailAddress());
if ($user instanceof User) {
$participant->user_id = $user->getId();
$participant->save();
}
}
private function findCrmDomainRecords(
?ServiceInterface $crmService,
Participant $participant,
Activity $activity,
): array {
if ($participant->hasEmailAddress()) {
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
$records = $this->decorator->matchByDomain(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
if (! empty($records)) {
return $records;
}
}
return [];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CrmActivityService.php
|
NULL
|
9154
|
|
9153
|
Computing annotation for CrmActivityService.php
Pr Computing annotation for CrmActivityService.php
Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}...
|
PhpStorm
|
faVsco.js – CrmActivityService.php
|
NULL
|
9153
|
|
9152
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
1
5
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Illuminate\Support\Collection;
use Jiminny\Contracts\Repositories\TeamRepository;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\InvalidArgumentException;
use Jiminny\Exceptions\SocialAccountTokenInvalidException;
use Jiminny\Models\Account;
use Jiminny\Models\Activity;
use Jiminny\Models\Contact;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Participant;
use Jiminny\Models\Stage;
use Jiminny\Models\Team;
use Jiminny\Models\User;
use Jiminny\Services\ResolveTeamCrmConnection;
use Psr\Container\ContainerExceptionInterface;
use Psr\Container\NotFoundExceptionInterface;
use Psr\Log\LoggerInterface;
use Exception;
use Throwable;
class CrmActivityService
{
public function __construct(
private readonly TeamRepository $teamRepository,
private readonly CachedCrmServiceDecorator $decorator,
private readonly EmailHelper $emailHelper,
private readonly ResolveTeamCrmConnection $teamCrmResolver,
private readonly LoggerInterface $logger,
) {
}
/**
* Updates CRM data for an activity and its participants.
*
* NOTE: This method performs multiple database writes and should be called
* within a transaction by the caller to ensure atomicity.
*
* @param Activity $activity
* @param bool $remoteSearch
*
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
* @throws Exception
*/
public function updateCrmData(
Activity $activity,
bool $remoteSearch = false,
): void {
$crmService = null;
$participants = $activity->getParticipants();
$team = $activity->getTeam();
$prospectSearchStrategy = ProspectSearchStrategyFactory::match($team);
if ($prospectSearchStrategy->ignoreCrmMatchData()) {
$this->logger->info('[CrmActivityService] Ignoring crm data because of prospect strategy', [
'activity_id' => $activity->getId(),
'strategy' => get_class($prospectSearchStrategy),
]);
return;
}
if ($remoteSearch) {
try {
$crmService = $this->teamCrmResolver->resolveForTeam($team);
} catch (SocialAccountTokenInvalidException) {
$this->logger->warning('[CrmActivityService] CRM token expired, falling back to local search', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
]);
}
}
$records = $this->updateParticipantsCrmData(
team: $team,
activity: $activity,
participants: $participants,
crmService: $crmService,
);
if (! empty($records)) {
$activity->updateActivityCrmData($records);
}
$activity->refresh();
}
/**
* @param Collection<Participant> $participants
*
* @throws Exception
*
* @return array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}|array{}
*/
private function updateParticipantsCrmData(
Team $team,
Activity $activity,
Collection $participants,
?ServiceInterface $crmService = null,
): array {
$matchedRecords = [];
$matchedDomainRecords = [];
$this->validateCrmConfiguration($activity);
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
foreach ($participants as $participant) {
if ($this->shouldSkipParticipant($participant)) {
continue;
}
if (! $this->shouldPerformLookup($participant, $team)) {
$this->logger->info('[CrmActivityService] Email domain belongs to the team, skipping crm lookup', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
'email' => $participant->getEmailAddress(),
]);
$this->attachUserIfExists($participant, $team);
continue;
}
$records = $this->findCrmRecords($participant, $activity);
if (! empty($records)) {
$matchedRecords[] = $records;
} else {
$records = $this->findCrmDomainRecords(
crmService: $crmService,
participant: $participant,
activity: $activity,
);
if (! empty($records)) {
$matchedDomainRecords[] = $records;
}
}
if (empty($records)) {
continue;
}
try {
$activity->updateParticipantCrmData($records, $participant);
} catch (Throwable $ex) {
$this->logger->error('[CrmActivityService] Failed to update participant CRM data', [
'activity_id' => $activity->getId(),
'participant_id' => $participant->getId(),
'exception' => $ex->getMessage(),
]);
continue;
}
}
$bestMatch = $this->getBestMatch(
matchedRecords : $matchedRecords,
matchedDomainRecords: $matchedDomainRecords,
);
$this->logger->info('[CrmActivityService] CRM matching completed', [
'activity_id' => $activity->getId(),
'participants_processed' => $participants->count(),
'exact_matches' => count($matchedRecords),
'domain_matches' => count($matchedDomainRecords),
'best_match_found' => ! empty($bestMatch),
]);
return $bestMatch;
}
private function shouldPerformLookup(Participant $participant, Team $team): bool
{
if ($participant->hasEmailAddress()) {
return $this->emailHelper->shouldPerformLookup($team, $participant->getEmailAddress());
}
return true;
}
private function validateCrmConfiguration(Activity $activity): void
{
if ($activity->getCrm() === null) {
throw new InvalidArgumentException('Cannot find CRM configuration');
}
}
private function getBestMatch(?array $matchedRecords, ?array $matchedDomainRecords): array
{
return RecordSelector::pickBestFromLists($matchedRecords, $matchedDomainRecords);
}
private function findCrmRecords(Participant $participant, Activity $activity): ?array
{
$records = null;
if ($participant->hasEmailAddress()) {
$records = $this->decorator->matchExactlyByEmail(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
}
if (empty($records) && $participant->getPhoneNumber() !== null) {
$records = $this->decorator->matchByPhone(
phone: $participant->getPhoneNumber(),
userId: $activity->getUser()->getId(),
);
}
if (empty($records) && $participant->getName() !== null) {
$records = $this->decorator->matchByName(
name: $participant->getName(),
userId: $activity->getUser()->getId(),
);
}
return $records;
}
private function shouldSkipParticipant(Participant $participant): bool
{
return $participant->hasUser();
}
private function attachUserIfExists(Participant $participant, Team $team): void
{
if ($participant->hasEmailAddress() === false) {
return;
}
$user = $this->teamRepository->findActiveTeamMemberByEmail($team, $participant->getEmailAddress());
if ($user instanceof User) {
$participant->user_id = $user->getId();
$participant->save();
}
}
private function findCrmDomainRecords(
?ServiceInterface $crmService,
Participant $participant,
Activity $activity,
): array {
if ($participant->hasEmailAddress()) {
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
$records = $this->decorator->matchByDomain(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
if (! empty($records)) {
return $records;
}
}
return [];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CrmActivityService.php
|
NULL
|
9152
|
|
9151
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
1
5
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Illuminate\Support\Collection;
use Jiminny\Contracts\Repositories\TeamRepository;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\InvalidArgumentException;
use Jiminny\Exceptions\SocialAccountTokenInvalidException;
use Jiminny\Models\Account;
use Jiminny\Models\Activity;
use Jiminny\Models\Contact;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Participant;
use Jiminny\Models\Stage;
use Jiminny\Models\Team;
use Jiminny\Models\User;
use Jiminny\Services\ResolveTeamCrmConnection;
use Psr\Container\ContainerExceptionInterface;
use Psr\Container\NotFoundExceptionInterface;
use Psr\Log\LoggerInterface;
use Exception;
use Throwable;
class CrmActivityService
{
public function __construct(
private readonly TeamRepository $teamRepository,
private readonly CachedCrmServiceDecorator $decorator,
private readonly EmailHelper $emailHelper,
private readonly ResolveTeamCrmConnection $teamCrmResolver,
private readonly LoggerInterface $logger,
) {
}
/**
* Updates CRM data for an activity and its participants.
*
* NOTE: This method performs multiple database writes and should be called
* within a transaction by the caller to ensure atomicity.
*
* @param Activity $activity
* @param bool $remoteSearch
*
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
* @throws Exception
*/
public function updateCrmData(
Activity $activity,
bool $remoteSearch = false,
): void {
$crmService = null;
$participants = $activity->getParticipants();
$team = $activity->getTeam();
$prospectSearchStrategy = ProspectSearchStrategyFactory::match($team);
if ($prospectSearchStrategy->ignoreCrmMatchData()) {
$this->logger->info('[CrmActivityService] Ignoring crm data because of prospect strategy', [
'activity_id' => $activity->getId(),
'strategy' => get_class($prospectSearchStrategy),
]);
return;
}
if ($remoteSearch) {
try {
$crmService = $this->teamCrmResolver->resolveForTeam($team);
} catch (SocialAccountTokenInvalidException) {
$this->logger->warning('[CrmActivityService] CRM token expired, falling back to local search', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
]);
}
}
$records = $this->updateParticipantsCrmData(
team: $team,
activity: $activity,
participants: $participants,
crmService: $crmService,
);
if (! empty($records)) {
$activity->updateActivityCrmData($records);
}
$activity->refresh();
}
/**
* @param Collection<Participant> $participants
*
* @throws Exception
*
* @return array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}|array{}
*/
private function updateParticipantsCrmData(
Team $team,
Activity $activity,
Collection $participants,
?ServiceInterface $crmService = null,
): array {
$matchedRecords = [];
$matchedDomainRecords = [];
$this->validateCrmConfiguration($activity);
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
foreach ($participants as $participant) {
if ($this->shouldSkipParticipant($participant)) {
continue;
}
if (! $this->shouldPerformLookup($participant, $team)) {
$this->logger->info('[CrmActivityService] Email domain belongs to the team, skipping crm lookup', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
'email' => $participant->getEmailAddress(),
]);
$this->attachUserIfExists($participant, $team);
continue;
}
$records = $this->findCrmRecords($participant, $activity);
if (! empty($records)) {
$matchedRecords[] = $records;
} else {
$records = $this->findCrmDomainRecords(
crmService: $crmService,
participant: $participant,
activity: $activity,
);
if (! empty($records)) {
$matchedDomainRecords[] = $records;
}
}
if (empty($records)) {
continue;
}
try {
$activity->updateParticipantCrmData($records, $participant);
} catch (Throwable $ex) {
$this->logger->error('[CrmActivityService] Failed to update participant CRM data', [
'activity_id' => $activity->getId(),
'participant_id' => $participant->getId(),
'exception' => $ex->getMessage(),
]);
continue;
}
}
$bestMatch = $this->getBestMatch(
matchedRecords : $matchedRecords,
matchedDomainRecords: $matchedDomainRecords,
);
$this->logger->info('[CrmActivityService] CRM matching completed', [
'activity_id' => $activity->getId(),
'participants_processed' => $participants->count(),
'exact_matches' => count($matchedRecords),
'domain_matches' => count($matchedDomainRecords),
'best_match_found' => ! empty($bestMatch),
]);
return $bestMatch;
}
private function shouldPerformLookup(Participant $participant, Team $team): bool
{
if ($participant->hasEmailAddress()) {
return $this->emailHelper->shouldPerformLookup($team, $participant->getEmailAddress());
}
return true;
}
private function validateCrmConfiguration(Activity $activity): void
{
if ($activity->getCrm() === null) {
throw new InvalidArgumentException('Cannot find CRM configuration');
}
}
private function getBestMatch(?array $matchedRecords, ?array $matchedDomainRecords): array
{
return RecordSelector::pickBestFromLists($matchedRecords, $matchedDomainRecords);
}
private function findCrmRecords(Participant $participant, Activity $activity): ?array
{
$records = null;
if ($participant->hasEmailAddress()) {
$records = $this->decorator->matchExactlyByEmail(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
}
if (empty($records) && $participant->getPhoneNumber() !== null) {
$records = $this->decorator->matchByPhone(
phone: $participant->getPhoneNumber(),
userId: $activity->getUser()->getId(),
);
}
if (empty($records) && $participant->getName() !== null) {
$records = $this->decorator->matchByName(
name: $participant->getName(),
userId: $activity->getUser()->getId(),
);
}
return $records;
}
private function shouldSkipParticipant(Participant $participant): bool
{
return $participant->hasUser();
}
private function attachUserIfExists(Participant $participant, Team $team): void
{
if ($participant->hasEmailAddress() === false) {
return;
}
$user = $this->teamRepository->findActiveTeamMemberByEmail($team, $participant->getEmailAddress());
if ($user instanceof User) {
$participant->user_id = $user->getId();
$participant->save();
}
}
private function findCrmDomainRecords(
?ServiceInterface $crmService,
Participant $participant,
Activity $activity,
): array {
if ($participant->hasEmailAddress()) {
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
$records = $this->decorator->matchByDomain(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
if (! empty($records)) {
return $records;
}
}
return [];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CrmActivityService.php
|
NULL
|
9151
|
|
9150
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
8
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Jobs\Crm;
use Exception;
use Illuminate\Contracts\Queue\ShouldBeUnique;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Database\Connection;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use Illuminate\Support\Facades\Log;
use Jiminny\Component\Queue\Constants;
use Jiminny\Exceptions\InvalidArgumentException;
use Jiminny\Jobs\Job;
use Jiminny\Models\Activity;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Repositories\ActivityRepository;
use Jiminny\Services\Crm\CrmActivityService;
use Psr\Container\ContainerExceptionInterface;
use Psr\Container\NotFoundExceptionInterface;
use Throwable;
class MatchActivityCrmData extends Job implements ShouldQueue, ShouldBeUnique
{
use InteractsWithQueue;
use SerializesModels;
public int $tries = 3;
private int $activityId;
private ?Configuration $fromConfiguration;
private bool $remoteSearch;
public function __construct(
int $activityId,
?Configuration $fromConfiguration = null,
bool $remoteSearch = false,
) {
$this->activityId = $activityId;
$this->fromConfiguration = $fromConfiguration;
$this->remoteSearch = $remoteSearch;
$this->onQueue(Constants::QUEUE_ANALYTICS_LOW);
}
public function uniqueId(): string
{
$configId = $this->fromConfiguration?->getId() ?? 0;
$remote = $this->remoteSearch ? 'remote' : 'local';
return "$this->activityId:$configId:$remote";
}
public function timeout(): int
{
return 300; // 5 minutes max execution time
}
public function uniqueFor(): int
{
return $this->timeout() + 60; // timeout + 1 minute buffer
}
public function backoff(): array
{
return [30, 90, 180];
}
/**
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
* @throws Exception|Throwable
*/
public function handle(
ActivityRepository $activityRepository,
CrmActivityService $crmActivityService,
Connection $connection,
): void {
$activity = $activityRepository->findById($this->activityId);
if ($activity === null) {
throw new InvalidArgumentException('[MatchActivityCrmData] Cannot find activity.');
}
try {
$connection->transaction(function () use ($activity, $crmActivityService, $activityRepository) {
Log::info('[MatchActivityCrmData] Starting CRM data matching', [
'activity' => $this->activityId,
'remote_search' => $this->remoteSearch,
'set_configuration' => $this->fromConfiguration?->getId(),
'old_state' => [
'lead_id' => $activity->getLead()?->getId(),
'contact_id' => $activity->getContact()?->getId(),
'account_id' => $activity->getAccount()?->getId(),
'opportunity_id' => $activity->getOpportunity()?->getId(),
'stage_id' => $activity->getStage()?->getId(),
],
]);
$this->resetCrmMappings($activity, $activityRepository);
$this->switchCrmConfigurationIfNeeded($activity);
$activity->refresh();
$crmActivityService->updateCrmData(
activity: $activity,
remoteSearch: $this->remoteSearch,
);
$hasMatch = $activity->getLead() !== null
|| $activity->getContact() !== null
|| $activity->getAccount() !== null
|| $activity->getOpportunity() !== null;
if ($hasMatch) {
Log::info('[MatchActivityCrmData] Successfully matched CRM data', [
'activity' => $this->activityId,
'remote_search' => $this->remoteSearch,
'lead_id' => $activity->getLead()?->getId(),
'contact_id' => $activity->getContact()?->getId(),
'account_id' => $activity->getAccount()?->getId(),
'opportunity_id' => $activity->getOpportunity()?->getId(),
'stage_id' => $activity->getStage()?->getId(),
]);
} else {
Log::info('[MatchActivityCrmData] No CRM match found', [
'activity' => $this->activityId,
'remote_search' => $this->remoteSearch,
]);
}
});
} catch (Throwable $e) {
Log::error('[MatchActivityCrmData] Failed to match CRM data', [
'activity' => $this->activityId,
'remote_search' => $this->remoteSearch,
'exception' => $e->getMessage(),
'trace' => $e->getTraceAsString(),
]);
throw $e;
}
}
public function failed(Throwable $exception): void
{
Log::error('[MatchActivityCrmData] Job permanently failed after all retries', [
'activity' => $this->activityId,
'remote_search' => $this->remoteSearch,
'from_configuration' => $this->fromConfiguration?->getId(),
'exception' => $exception->getMessage(),
'attempts' => $this->attempts(),
]);
}
private function resetCrmMappings(
Activity $activity,
ActivityRepository $activityRepository
): void {
$activity->update([
'lead_id' => null,
'contact_id' => null,
'account_id' => null,
'opportunity_id' => null,
'stage_id' => null,
]);
$participantsOldState = $activityRepository->getActivityParticipants($activity)
->map(function ($participant) {
return [
'id' => $participant->id,
'user_id' => $participant->user_id,
'contact_id' => $participant->contact_id,
'lead_id' => $participant->lead_id,
];
});
if ($participantsOldState->isNotEmpty()) {
Log::info('[MatchActivityCrmData] Participants old state', [
'activity' => $this->activityId,
'participants' => $participantsOldState->toArray(),
]);
}
$activity->participants()->update([
'user_id' => null,
'contact_id' => null,
'lead_id' => null,
]);
}
private function switchCrmConfigurationIfNeeded(Activity $activity): void
{
if ($this->fromConfiguration === null) {
return;
}
if ($activity->getCrm()?->getId() === $this->fromConfiguration->getId()) {
return;
}
Log::info('[MatchActivityCrmData] Switching CRM configuration', [
'activity' => $this->activityId,
'old_configuration' => $activity->getCrm()?->getId(),
'new_configuration' => $this->fromConfiguration->getId(),
]);
$activity->update([
'crm_configuration_id' => $this->fromConfiguration->getId(),
'crm_provider_id' => null,
]);
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – MatchActivityCrmData.php
|
NULL
|
9150
|
|
9149
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
8
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Jobs\Crm;
use Exception;
use Illuminate\Contracts\Queue\ShouldBeUnique;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Database\Connection;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use Illuminate\Support\Facades\Log;
use Jiminny\Component\Queue\Constants;
use Jiminny\Exceptions\InvalidArgumentException;
use Jiminny\Jobs\Job;
use Jiminny\Models\Activity;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Repositories\ActivityRepository;
use Jiminny\Services\Crm\CrmActivityService;
use Psr\Container\ContainerExceptionInterface;
use Psr\Container\NotFoundExceptionInterface;
use Throwable;
class MatchActivityCrmData extends Job implements ShouldQueue, ShouldBeUnique
{
use InteractsWithQueue;
use SerializesModels;
public int $tries = 3;
private int $activityId;
private ?Configuration $fromConfiguration;
private bool $remoteSearch;
public function __construct(
int $activityId,
?Configuration $fromConfiguration = null,
bool $remoteSearch = false,
) {
$this->activityId = $activityId;
$this->fromConfiguration = $fromConfiguration;
$this->remoteSearch = $remoteSearch;
$this->onQueue(Constants::QUEUE_ANALYTICS_LOW);
}
public function uniqueId(): string
{
$configId = $this->fromConfiguration?->getId() ?? 0;
$remote = $this->remoteSearch ? 'remote' : 'local';
return "$this->activityId:$configId:$remote";
}
public function timeout(): int
{
return 300; // 5 minutes max execution time
}
public function uniqueFor(): int
{
return $this->timeout() + 60; // timeout + 1 minute buffer
}
public function backoff(): array
{
return [30, 90, 180];
}
/**
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
* @throws Exception|Throwable
*/
public function handle(
ActivityRepository $activityRepository,
CrmActivityService $crmActivityService,
Connection $connection,
): void {
$activity = $activityRepository->findById($this->activityId);
if ($activity === null) {
throw new InvalidArgumentException('[MatchActivityCrmData] Cannot find activity.');
}
try {
$connection->transaction(function () use ($activity, $crmActivityService, $activityRepository) {
Log::info('[MatchActivityCrmData] Starting CRM data matching', [
'activity' => $this->activityId,
'remote_search' => $this->remoteSearch,
'set_configuration' => $this->fromConfiguration?->getId(),
'old_state' => [
'lead_id' => $activity->getLead()?->getId(),
'contact_id' => $activity->getContact()?->getId(),
'account_id' => $activity->getAccount()?->getId(),
'opportunity_id' => $activity->getOpportunity()?->getId(),
'stage_id' => $activity->getStage()?->getId(),
],
]);
$this->resetCrmMappings($activity, $activityRepository);
$this->switchCrmConfigurationIfNeeded($activity);
$activity->refresh();
$crmActivityService->updateCrmData(
activity: $activity,
remoteSearch: $this->remoteSearch,
);
$hasMatch = $activity->getLead() !== null
|| $activity->getContact() !== null
|| $activity->getAccount() !== null
|| $activity->getOpportunity() !== null;
if ($hasMatch) {
Log::info('[MatchActivityCrmData] Successfully matched CRM data', [
'activity' => $this->activityId,
'remote_search' => $this->remoteSearch,
'lead_id' => $activity->getLead()?->getId(),
'contact_id' => $activity->getContact()?->getId(),
'account_id' => $activity->getAccount()?->getId(),
'opportunity_id' => $activity->getOpportunity()?->getId(),
'stage_id' => $activity->getStage()?->getId(),
]);
} else {
Log::info('[MatchActivityCrmData] No CRM match found', [
'activity' => $this->activityId,
'remote_search' => $this->remoteSearch,
]);
}
});
} catch (Throwable $e) {
Log::error('[MatchActivityCrmData] Failed to match CRM data', [
'activity' => $this->activityId,
'remote_search' => $this->remoteSearch,
'exception' => $e->getMessage(),
'trace' => $e->getTraceAsString(),
]);
throw $e;
}
}
public function failed(Throwable $exception): void
{
Log::error('[MatchActivityCrmData] Job permanently failed after all retries', [
'activity' => $this->activityId,
'remote_search' => $this->remoteSearch,
'from_configuration' => $this->fromConfiguration?->getId(),
'exception' => $exception->getMessage(),
'attempts' => $this->attempts(),
]);
}
private function resetCrmMappings(
Activity $activity,
ActivityRepository $activityRepository
): void {
$activity->update([
'lead_id' => null,
'contact_id' => null,
'account_id' => null,
'opportunity_id' => null,
'stage_id' => null,
]);
$participantsOldState = $activityRepository->getActivityParticipants($activity)
->map(function ($participant) {
return [
'id' => $participant->id,
'user_id' => $participant->user_id,
'contact_id' => $participant->contact_id,
'lead_id' => $participant->lead_id,
];
});
if ($participantsOldState->isNotEmpty()) {
Log::info('[MatchActivityCrmData] Participants old state', [
'activity' => $this->activityId,
'participants' => $participantsOldState->toArray(),
]);
}
$activity->participants()->update([
'user_id' => null,
'contact_id' => null,
'lead_id' => null,
]);
}
private function switchCrmConfigurationIfNeeded(Activity $activity): void
{
if ($this->fromConfiguration === null) {
return;
}
if ($activity->getCrm()?->getId() === $this->fromConfiguration->getId()) {
return;
}
Log::info('[MatchActivityCrmData] Switching CRM configuration', [
'activity' => $this->activityId,
'old_configuration' => $activity->getCrm()?->getId(),
'new_configuration' => $this->fromConfiguration->getId(),
]);
$activity->update([
'crm_configuration_id' => $this->fromConfiguration->getId(),
'crm_provider_id' => null,
]);
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – MatchActivityCrmData.php
|
NULL
|
9149
|
|
9148
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Code changed:
Hide
Sync Changes
Hide This Notification
7
48
1
33
1
Previous Highlighted Error
Next Highlighted Error
<?php
namespace Jiminny\Services\Crm\Hubspot;
use Carbon\Carbon;
use Exception;
use Generator;
use GuzzleHttp\Exception\RequestException;
use Illuminate\Support\Facades\Cache;
use InvalidArgumentException;
use Jiminny\Contracts\Repositories\TeamRepository;
use Jiminny\Contracts\Services\Crm\ClientInterface;
use Jiminny\Contracts\Services\Crm\FetchRelatedActivityInterface;
use Jiminny\Contracts\Services\Crm\LayoutManagementInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesInterface;
use Jiminny\Contracts\Services\Crm\Provider\HubspotInterface;
use Jiminny\Contracts\Services\Crm\RemoteEntityLookupInterface;
use Jiminny\Contracts\Services\Crm\RemoteEntityManipulationInterface;
use Jiminny\Contracts\Services\Crm\SavePlaybackLinkToCrmInterface;
use Jiminny\Contracts\Services\Crm\SendSummaryToCrmInterface;
use Jiminny\Contracts\Services\Crm\SettingsInterface;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Contracts\Services\Crm\SyncCrmMetadataInterface;
use Jiminny\Contracts\Services\Crm\VerifyTaskExistsInterface;
use Jiminny\Exceptions\CrmException;
use Jiminny\Exceptions\HttpNotFoundException;
use Jiminny\Jobs\Crm\NoteObject;
use Jiminny\Models\Account;
use Jiminny\Models\Activity;
use Jiminny\Models\Contact;
use Jiminny\Models\Contracts\ActivityContract;
use Jiminny\Models\Crm\BusinessProcess;
use Jiminny\Models\Crm\Field;
use Jiminny\Models\Crm\FieldData;
use Jiminny\Models\Crm\Layout;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Participant;
use Jiminny\Models\Playbook;
use Jiminny\Models\SocialAccount;
use Jiminny\Models\Stage;
use Jiminny\Models\User;
use Jiminny\Repositories\Crm\CrmEntityRepository;
use Jiminny\Repositories\Crm\FieldRepository;
use Jiminny\Repositories\Crm\ProfileRepository;
use Jiminny\Repositories\ParticipantRepository;
use Jiminny\Services\Avatar\ProspectPhotoPathService;
use Jiminny\Services\Crm\BaseService;
use Jiminny\Services\Crm\Hubspot\Actions\SyncArchivedProfilesAction;
use Jiminny\Services\Crm\Hubspot\Fields\ValueNormalizer;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\OpportunitySyncTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\SyncCrmEntitiesTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\SyncFieldsTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\WriteCrmTrait;
use Jiminny\Services\Crm\MatchDomainByEmailInterface;
use Jiminny\Services\Crm\OpportunitySyncStrategyResolver;
use Jiminny\Services\Crm\ResolveCompanyNameByEmailTrait;
use Jiminny\Utils\PlaybackUrlBuilder;
use Sentry;
use SevenShores\Hubspot\Exceptions\BadRequest;
use Throwable;
use UnexpectedValueException;
/**
* @phpstan-type CrmFieldDefinition array{
* name: string,
* label: string,
* description: string,
* type: string,
* fieldType: string,
* hidden: bool,
* showCurrencySymbol: bool,
* options: array<array{
* id: string,
* label: string,
* value?: string,
* }
*/
class Service extends BaseService implements
HubspotInterface,
SyncCrmEntitiesInterface,
SyncCrmMetadataInterface,
SendSummaryToCrmInterface,
MatchDomainByEmailInterface,
SavePlaybackLinkToCrmInterface,
RemoteEntityManipulationInterface,
FetchRelatedActivityInterface,
LayoutManagementInterface,
SettingsInterface,
MatchCrmEntitiesInterface,
RemoteEntityLookupInterface,
VerifyTaskExistsInterface
{
use ResolveCompanyNameByEmailTrait;
use SyncCrmEntitiesTrait;
use WriteCrmTrait;
use SyncFieldsTrait;
use OpportunitySyncTrait;
private const int ENGAGEMENT_BODY_MAX_LENGTH = 65536;
private const string LOG_DATE_FORMAT = 'Y-m-d H:i:s';
private const int BATCH_UPDATE_LIMIT = 100;
private const string TEN_SECONDLY_ROLLING_POLICY = 'TEN_SECONDLY_ROLLING';
private const int TEN_SECONDLY_ROLLING_LIMIT = 10;
private const string CALLS_SEARCH_ENDPOINT = '[URL_WITH_CREDENTIALS] ClientInterface|Client
*/
protected $client;
protected OpportunitySyncStrategyResolver $opportunitySyncStrategyResolver;
protected CrmEntityRepository $crmEntityRepository;
protected ProspectPhotoPathService $prospectPhotoPathService;
private SyncFieldAction $syncFieldAction;
private PayloadBuilder $payloadBuilder;
private SyncRelatedActivityManager $syncRelatedActivityManager;
private SyncArchivedProfilesAction $syncArchivedProfilesAction;
private WebhookSyncBatchProcessor $batchProcessor;
public function __construct(
Client $client,
SyncFieldAction $syncFieldAction,
PayloadBuilder $payloadBuilder,
ProspectPhotoPathService $prospectPhotoPathService,
SyncArchivedProfilesAction $syncArchivedProfilesAction,
WebhookSyncBatchProcessor $batchProcessor,
) {
parent::__construct();
$this->client = $client;
$this->syncFieldAction = $syncFieldAction;
$this->prospectPhotoPathService = $prospectPhotoPathService;
$this->payloadBuilder = $payloadBuilder;
$this->syncArchivedProfilesAction = $syncArchivedProfilesAction;
$this->batchProcessor = $batchProcessor;
$this->opportunitySyncStrategyResolver = app(OpportunitySyncStrategyResolver::class, [
'client' => $this->client,
]);
$this->syncRelatedActivityManager = app(SyncRelatedActivityManager::class, [
'client' => $this->client,
'payloadBuilder' => $this->payloadBuilder,
'logger' => $this->logger,
]);
$this->crmEntityRepository = app(CrmEntityRepository::class);
$this->dealFieldsService = app(DealFieldsService::class);
}
public function getDisplayName(): string
{
return 'HubSpot';
}
protected function getOAuthAccount(User $user): ?SocialAccount
{
// In this case, the Account Owner is always the connection for any API operations.
$owner = $user->team->owner;
return $owner->getSocialAccount(SocialAccount::PROVIDER_HUBSPOT);
}
public function getClient(): Client
{
/** @var Client */
return $this->client;
}
/**
* Convert raw field data into a format compatible with CRM APIs.
*
* @param bool $internal Direction of the conversion.
* True is pulling from CRM, false normalize before sending to CRM.
*/
public function normalizeValue(string $fieldType, string $fieldValue, bool $internal = false): string
{
return ValueNormalizer::normalize(
fieldType: $fieldType,
fieldValue: $fieldValue,
isInbound: $internal,
);
}
/**
* @inheritdoc
*/
public function getDefaultFields(string $activityType): array
{
$fields = [];
if ($activityType === Playbook::ACTIVITY_TYPE_TASK) {
$defaultFields = FieldDefinitions::defaultTaskFields();
// This lazy creates these fields if not already setup.
foreach ($defaultFields as $defaultField) {
$fields[] = $this->config->fields()->firstOrCreate($defaultField);
}
}
return $fields;
}
/**
* @inheritdoc
*/
public function getDefaultActivityField(string $activityType): Field
{
/** @var Field $activityField */
$activityField = $this->config->fields()->where([
'crm_provider_id' => 'activityType',
'object_type' => $activityType,
])->first();
return $activityField;
}
/**
* @inheritdoc
*/
public function getSupportedPlaybookTypes(): array
{
return [Playbook::ACTIVITY_TYPE_TASK];
}
/**
* @inheritdoc
*/
public function getDefaultActivityLayoutFields(string $activityType, string $layoutType): array
{
$fields = [];
if ($activityType === Playbook::ACTIVITY_TYPE_TASK) {
// Outcome should always be provided calls/meetings.
$fieldData = [
[
'crm_provider_id' => $layoutType === Layout::TYPE_SOFTPHONE_SUMMARY ? 'disposition' : 'meetingOutcome',
'object_type' => Field::OBJECT_TASK,
],
];
foreach ($fieldData as $data) {
$field = $this->config->fields()->where($data)->first();
// Only add the field if it is created, which it should be.
if ($field) {
$fields[] = $field;
}
}
}
return $fields;
}
public function getDealInsightsFields(): array
{
return FieldDefinitions::dealInsightsFields();
}
protected function getDefaultFollowupLayoutFields(string $activityType): array
{
$fields = [];
$fieldRepo = app(FieldRepository::class);
$fieldData = FieldDefinitions::followupFieldsFilter();
foreach ($fieldData as $data) {
$field = $fieldRepo->findOneConfigurationFieldByProperties($this->config, $data);
// Only add the field if it is created, which it should be.
if ($field) {
$fields[] = $field;
}
}
return $fields;
}
/**
* @inheritdoc
*/
public function syncField(Field $field): void
{
switch ($field->object_type) {
case Field::OBJECT_ACCOUNT:
$crmField = $this->client->getInstance()->companyProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_CONTACT:
$crmField = $this->client->getInstance()->contactProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_OPPORTUNITY:
$crmField = $this->client->getInstance()->dealProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_TASK:
$this->syncSingleTaskField($field);
return;
default:
return;
}
$this->syncFieldAction->execute($field, $crmField->toArray());
}
/**
* @param array<array{
* id:string,
* label:string,
* value?:string
* }> $options
*
* @throws CrmException
*
* @return FieldData[]
*
*/
public function importPicklistValues(
Field $field,
array $options = [['id' => '', 'label' => '', 'value' => '']],
): array {
if (! empty($options[0]['id']) || ! empty($options[0]['value'])) {
// We already have the options, no need to fetch them again
return $this->importOptions($field, $options);
}
$options = [];
switch ($field->getObjectType()) {
case Field::OBJECT_ACCOUNT:
$options = $this->getClient()->fetchPropertyOptions('company', $field->getCrmProviderId());
break;
case Field::OBJECT_CONTACT:
$options = $this->getClient()->fetchPropertyOptions('contact', $field->getCrmProviderId());
break;
case Field::OBJECT_OPPORTUNITY:
// Hubspot has different endpoint for stages
$options = $this->getClient()->fetchOpportunityFieldOptions($field);
break;
case Field::OBJECT_TASK:
if ($field->getCrmProviderId() === 'disposition') {
$options = $this->getClient()->fetchDispositionFieldOptions();
} elseif (in_array($field->getCrmProviderId(), ['meetingOutcome', 'activityType'])) {
$options = $this->getClient()->fetchMeetingOutcomeFieldOptions($field);
}
break;
default:
$this->logger->warning('Invalid object type', [
'object_type' => $field->getObjectType(),
'field_id' => $field->getId(),
]);
throw new CrmException('Invalid object type');
}
return $this->importOptions($field, $options);
}
/**
* @inheritdoc
*/
public function importStages(?array $types = null, ?string $missingStageName = null): ?Stage
{
$missingStage = null;
try {
// Use the HubSpot API client instead of the SDK crmPipelines() method
$endpoint = self::getDealsPipelinesEndpoint();
$pipelinesResponse = $this->client->getInstance()->getClient()->request('GET', $endpoint);
$pipelines = $pipelinesResponse->data->results;
} catch (RequestException|BadRequest $exception) {
throw $exception;
}
foreach ($pipelines as $pipeline) {
$stages = [];
// We create a business process to contain the pipeline, and store all stages against it.
$p = ResponseNormalize::normalizePipeline($pipeline);
// Create/update business process for this pipeline
$businessProcess = $this->config->businessProcesses()->updateOrCreate([
'crm_provider_id' => $p['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($p['label'], 0, 150),
'type' => BusinessProcess::TYPE_OPPORTUNITY,
'is_selectable' => $p['active'],
]);
// A record type is really a clone of the business process, used to store which record uses which pipeline.
// Create/update record type clone
$this->config->recordTypes()->updateOrCreate([
'crm_provider_id' => $p['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($p['label'], 0, 150),
'is_selectable' => $p['active'],
'business_process_id' => $businessProcess->id ?? null,
]);
// Stages - fetch all existing stages upfront to avoid N+1 queries
$existingStages = $this->config->stages()
->withTrashed()
->where('type', Stage::TYPE_OPPORTUNITY)
->get()
->keyBy('crm_provider_id');
foreach ($p['stages'] as $dealStage) {
$s = ResponseNormalize::normalizeDealStage($dealStage);
/** @var ?Stage $existingStage */
$existingStage = $existingStages->get($s['id']);
// Restore soft-deleted stages that are now active in HubSpot
if ($existingStage?->trashed() && $s['active']) {
$existingStage->restore();
}
// Upsert stage (updates soft-deleted records without restoring them)
$stage = $this->config->stages()->withTrashed()->updateOrCreate([
'crm_provider_id' => $s['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($s['label'], 0, 50),
'label' => mb_strimwidth($s['label'], 0, 191),
'type' => Stage::TYPE_OPPORTUNITY,
'sequence' => $s['displayOrder'],
'is_selectable' => $s['active'],
'probability' => $s['probability'] * 100,
]);
if ($missingStageName === $s['id']) {
$missingStage = $stage;
}
$stages[] = $stage->id;
}
$businessProcess->stages()->sync($stages);
}
return $missingStage;
}
/**
* @inheritdoc
*/
public function syncOrganization(): void
{
try {
$endpoint = '[URL_WITH_CREDENTIALS]
*/
public function find(string $name, array $scopes): array
{
$count = $this->limit ?? 20;
$offset = $this->offset ?? 0;
/** @var array<int, array<string, mixed>> */
return Cache::remember(
key: $this->team->getId() . $name . $count . $offset,
ttl: 300,
callback: function () use ($name, $offset, $count): array {
$data = [];
// Use the new V3 API to find contacts based on additional fields.
foreach (['companies', 'contacts'] as $objectType) {
$endpoint = '[URL_WITH_CREDENTIALS]
*/
public function findOpportunities(?string $crmAccountId, ?string $crmContactId, ?int $userId = null): array
{
$data = [];
$ownerData = [];
$ownerId = null;
if ($crmAccountId === null) {
return $data;
}
if ($userId) {
$profileRepository = app(ProfileRepository::class);
$profile = $profileRepository->findProfileByUserId($this->config, $userId);
$ownerId = $profile instanceof Profile ? $profile->getCrmProviderId() : null;
}
$closedStages = $this->getClosedDealStages();
$payload = $this->payloadBuilder->generateOpportunitiesSearchPayload(
$this->config,
$crmAccountId,
$closedStages,
);
$results = $this->client->getPaginatedData($payload, 'deals');
foreach ($results['results'] as $object) {
$properties = $object['properties'];
$amount = null;
if (empty($properties['amount']) === false) {
$currency = $properties['deal_currency_code'] ?? $this->config->default_currency;
// Values can contain commas and any junk so strip them.
$value = (float) preg_replace('/[^\d.]/', '', $properties['amount']);
$amount = formatCurrency($value, $currency);
}
$businessProcess = $this->config
->businessProcesses()
->where('crm_provider_id', $properties['pipeline'])
->first();
if ($businessProcess === null) {
// Import it.
$stage = $this->importStages([Stage::TYPE_OPPORTUNITY], $properties['dealstage']);
$businessProcess = $this->config
->businessProcesses()
->where('crm_provider_id', $properties['pipeline'])
->first();
} else {
$stage = $businessProcess
->stages()
->where('crm_provider_id', $properties['dealstage'])
->where('type', Stage::TYPE_OPPORTUNITY)
->first();
if ($stage === null) {
// Import it.
$stage = $this->importStages(null, $properties['dealstage']);
}
}
$recordType = null;
if ($businessProcess) {
$recordType = $businessProcess->recordTypes()->first();
}
$isWon = in_array($properties['dealstage'], $closedStages['won']);
$isLost = in_array($properties['dealstage'], $closedStages['lost']);
$record = [
'crmId' => $object['id'],
'name' => $properties['dealname'] ?? 'Unknown Deal',
'value' => $amount,
'won' => $isWon,
'closed' => $isWon || $isLost,
'stage' => [
'id' => $stage?->getUuid() ?? '',
'name' => $stage?->getName() ?? '',
],
];
if ($recordType) {
$record += [
'recordType' => [
'id' => $recordType->id_string,
'name' => $recordType->name,
],
];
}
if ($ownerId && isset($properties['hubspot_owner_id']) && $properties['hubspot_owner_id'] === $ownerId) {
$ownerData[] = $record;
}
$data[] = $record;
}
if (! empty($ownerData)) {
return $ownerData;
}
return $data;
}
/**
* @inheritdoc
*/
public function getTasks(?string $objectType, string $objectId, ?string $opportunityId): array
{
$data = [];
switch ($objectType) {
case 'contact':
$hsObject = 'contact';
break;
case 'account':
$hsObject = 'company';
break;
default:
// This is a hack to prioritise and override a contact/company with a deal.
if ($opportunityId) {
$hsObject = 'deal';
$objectId = $opportunityId;
} else {
throw new InvalidArgumentException('Object type not supported.');
}
}
$engagementTypes = ['meetings', 'tasks'];
foreach ($engagementTypes as $engagementType) {
$payload = $this->payloadBuilder->getLinkToTaskPayload($hsObject, $objectId, $engagementType);
$this->logger->info('[HubSpot] CRM Search requested', [
'request' => $payload,
]);
$engagements = $this->client->getPaginatedData($payload, $engagementType);
foreach ($engagements['results'] as $engagement) {
if ($engagementType == 'meetings') {
$title = $engagement['properties']['hs_meeting_title'] ?? 'Scheduled meeting';
} elseif ($engagementType == 'tasks') {
$title = $engagement['properties']['hs_task_subject'];
} else {
$title = 'Scheduled meeting';
}
$data[] = [
'crmId' => $engagement['id'],
'subject' => $title,
'due' => $engagement['properties']['hs_timestamp'],
'type' => $engagement['properties']['hs_activity_type'] ?? null,
];
}
}
usort($data, function ($item1, $item2) {
return $item2['due'] <=> $item1['due'];
});
return $data;
}
/**
* Try to find CRM Objects using email address
*
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
$contactProperties = [
'email',
'firstname',
'lastname',
'country',
'phone',
'mobilephone',
'jobtitle',
'hubspot_owner_id',
'associatedcompanyid',
'photo',
];
$contact = null;
$account = null;
try {
$hsContact = $this->getClient()->getContactByEmail($email, $contactProperties);
if ($hsContact) {
$contact = $this->importContact($hsContact);
$account = $contact->account;
}
$data = $this->convertCrmData($contact, $account, $userId);
return ! empty(array_filter($data)) ? $data : null;
} catch (BadRequest $e) {
$this->logger->warning('[HubSpot] Search failed', [
'team_id' => $this->team->getId(),
'search_identifier' => $email,
'reason' => $e->getMessage(),
]);
}
return null;
}
public function getDomain(string $email): ?string
{
return $this->getDomainFromEmail($email);
}
/**
* Try to find CRM objects using domain name of the email address
*
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByDomain(string $domain, ?int $userId = null): ?array
{
$companyName = $domain;
// Try to find a company matching their email domain.
$companyProperties = [
'country',
'phone',
'name',
'hs_avatar_filemanager_key',
'industry',
'hubspot_owner_id',
'domain',
];
try {
$hsAccounts = $this->client
->getInstance()
->companies()
->searchByDomain($companyName, $companyProperties);
} catch (Throwable $e) {
$this->logger->info('[HubSpot] Search failed', [
'error' => $e->getMessage(),
'domain' => $domain,
]);
return null;
}
$account = null;
// If there are multiple accounts, don't guess, we'll ask later.
if (\count($hsAccounts->data->results) === 1) {
// Persist this remote object.
$account = $this->syncAccount($hsAccounts->data->results[0]->companyId);
}
$data = $this->convertCrmData(null, $account, $userId);
return ! empty(array_filter($data)) ? $data : null;
}
/**
* @return array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
protected function convertCrmData(?Contact $contact, ?Account $account, ?int $userId = null): array
{
$countryCode = null;
if ($contact && $contact->country_code) {
$countryCode = $contact->country_code;
} elseif ($account && $account->country_code) {
$countryCode = $account->country_code;
}
try {
$hsOpportunities = $this->findOpportunities(
$account ? $account->crm_provider_id : null,
$contact ? $contact->crm_provider_id : null,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
// If there are multiple opportunities, don't guess, we'll ask later.
$opportunity = null;
$stage = null;
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
}
protected function getCacheKey(string $object, ?int $userId = null): ?string
{
$key = $this->team->getId() . $object;
$keySuffix = $this->getOwnerKeySuffix($userId);
return $key . $keySuffix;
}
private function getOwnerKeySuffix(?int $userId = null): string
{
return $userId === null ? '' : (string) $userId;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
if (str_contains($phone, '**')) {
return null;
}
// trim all whitespaces if present so the lookup doesn't fail
$phone = str_replace(' ', '', $phone);
// Check if the user is internal.
if ($this->isPhoneNumberOfTeamMember($phone)) {
return null;
}
$response = $this->searchForPhoneNumber($phone);
if (empty($response)) {
return null;
}
// This would ideally importContact instead but the response type differs.
$contact = $this->findAndSyncContact($response['results'][0]['id']);
if (! $contact instanceof Contact) {
return null;
}
$account = $contact->account;
$countryCode = $contact->country_code ?? $account->country_code ?? null;
try {
$hsOpportunities = $this->findOpportunities(
$account?->crm_provider_id,
$contact->crm_provider_id,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
$opportunity = null;
$stage = null;
try {
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
} catch (Exception $e) {
$this->logger->debug('[HubSpot] Opportunity failed to sync.', [
'reason' => $e->getMessage(),
]);
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
}
private function isPhoneNumberOfTeamMember(string $phone): bool
{
$teamRepository = app(TeamRepository::class);
$user = $teamRepository->findTeamMemberByPhone($this->team, $phone);
if ($user instanceof User) {
return true;
}
return false;
}
private function findAndSyncContact(string $crmId): ?Contact
{
try {
return $this->syncContact($crmId);
} catch (Exception $exception) {
$this->logger->info('[HubSpot] Phone match failed', [
'reason' => $exception->getMessage(),
]);
return null;
}
}
private function hasResults(array $response): bool
{
return isset($response['total']) && is_numeric($response['total']) && $response['total'] > 0;
}
private function searchForPhoneNumber(string $phone): array
{
// Normalizes the provided phone number for the API search.
$normalizedPhone = $this->normalizePhoneNumber($phone);
$payload = $this->payloadBuilder->generatePhoneSearchPayload($normalizedPhone);
$this->logger->info('[HubSpot] Phone match search triggered', [
'phone' => $phone,
'normalizedPhone' => $normalizedPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($normalizedPhone, $payload);
if (! $this->hasResults($response)) {
$nationalPhone = preg_replace('/\D/', '', phone_national(null, $phone));
$payload = $this->payloadBuilder->generatePhoneSearchPayload($nationalPhone);
$this->logger->info('[HubSpot] Phone match national number search triggered', [
'phone' => $phone,
'nationalPhone' => $nationalPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($phone, $payload);
}
if (! $this->hasResults($response)) {
$payload = $this->payloadBuilder->generatePhoneSearchPayload($normalizedPhone, true);
$this->logger->info('[HubSpot] Phone match alternative search triggered', [
'phone' => $phone,
'normalizedPhone' => $normalizedPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($phone, $payload);
}
return $this->hasResults($response) ? $response : [];
}
private function handlePhoneSearchRequest(string $phone, array $payload): array
{
$endpoint = '[URL_WITH_CREDENTIALS] null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
// Don't waste time searching for single character strings.
if (\strlen($name) <= 1) {
return null;
}
$cacheKey = $this->getCacheKey($name, $userId);
$result = Cache::remember($cacheKey, 60, function () use ($name, $userId) {
$payload = $this->payloadBuilder->generateSearchContactsByNamePayload(
$name,
$this->getContactFields()
);
$hsContacts = $this->client->getPaginatedData($payload, 'contact');
if (empty($hsContacts['results'])) {
return false;
}
$contact = $this->importContact($hsContacts['results'][0]);
if ($contact === null) {
return false;
}
$account = $contact->account;
$countryCode = $contact->country_code ?? $account->country_code ?? null;
try {
$hsOpportunities = $this->findOpportunities(
$account ? $account->crm_provider_id : null,
$contact->crm_provider_id,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
$opportunity = null;
$stage = null;
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
});
return is_array($result) ? $result : null;
}
private function convertActivityAssociations(Activity $activity): array
{
return [
'contactIds' => $this->getParticipantsIds($activity),
'companyIds' => $activity->hasAccount() ? [$activity->account->crm_provider_id] : [],
'dealIds' => $activity->hasOpportunity() ? [$activity->opportunity->crm_provider_id] : [],
'ownerIds' => [],
];
}
private function getParticipantsIds(Activity $activity): array
{
$attendees = [];
$participantRepository = app(ParticipantRepository::class);
$participants = $participantRepository->getParticipantsWhoEnteredMeeting($activity);
foreach ($participants as $participant) {
if ($participant->user_id || $participant->isCoach()) {
continue;
}
$contact = $participant->contact()->first();
if ($contact && $contact->crm_provider_id) {
$attendees[] = $contact->crm_provider_id;
} else {
if (! empty($participant->name)) {
$attendeeData = $this->fetchMissingAttendeeInfo($participant);
}
if (! empty($attendeeData['id'])) {
$attendees[] = $attendeeData['id'];
}
}
}
if ($activity->hasContact()) {
$attendees[] = $activity->contact->crm_provider_id;
}
return array_unique($attendees);
}
private function fetchMissingAttendeeInfo(Participant $participant): array
{
// Check if we need to look inside an account context.
$activity = $participant->getActivity();
$companyId = $activity->hasAccount() ? $activity->getAccount()->crm_provider_id : null;
// First check the local data.
/** @var Contact[] $contacts */
$contacts = $this->team->contacts()
->with('account')
->where('name', $participant->name)
->whereNotNull('email')
->get();
foreach ($contacts as $contact) {
// If we have a company in scope, check the contact is associated to it.
if (
$companyId !== null
&& ($contact->account_id === null || $companyId !== $contact->account->crm_provider_id)
) {
continue;
}
return [
'id' => $contact->crm_provider_id,
'email' => $contact->email,
];
}
$payload = $this->generateNameSearchPayload($participant->name, 0, 20);
try {
$response = $this->client->getNewInstance()->crm()->contacts()->searchApi()->doSearch($payload);
// TODO add some logic to choose the most suitable contact if multiple
foreach ($response['results'] as $object) {
$properties = $object['properties'];
if (empty($object['properties']) === false) {
// Check the company matches the contact.
// Todo: Move this check inside the API search.
if ($companyId !== null && $companyId !== $properties['associatedcompanyid']) {
continue;
}
return [
'id' => $object['id'],
'email' => $properties['email'],
];
}
}
} catch (Exception $e) {
$this->logger->warning('[' . $this->getDisplayName() . '] Search failed', [
'teamId' => $this->team->id_string,
'request' => $payload,
'reason' => $e->getMessage(),
]);
}
return [];
}
/**
* Store transcripts as note engagement.
*
* @throws Exception
*/
public function createTranscriptNotes(Activity $activity): void
{
// For HS no need to check if Crm profile - Log Notes field is enabled
// We only check if store_transcript toggle is enabled on crm profile.
$engagement = [
'active' => true,
'ownerId' => $this->profile->crm_provider_id,
'timestamp' => $activity->created_at->tz($activity->user->timezone)->getTimestamp() * 1000,
'type' => 'NOTE',
];
// Generate activity transcription.
$transcriptionData = $this->generateTranscription($activity);
// Truncate Notes with max notes length because transcription text could be very long.
$transcripts = mb_strimwidth($transcriptionData, 0, static::ENGAGEMENT_BODY_MAX_LENGTH);
$metadata = [
'body' => $transcripts,
];
$associations = $this->convertActivityAssociations($activity);
try {
$hsEngagement = $this->client
->getInstance()
->engagements()
->create($engagement, $associations, $metadata);
$this->logCrmEngagementManipulation(self::ACTION_CREATE, $engagement, $metadata, $associations);
$noteId = $hsEngagement->data->engagement->id;
// Store crm logged id in transcription.
$transcription = $activity->getTranscription();
$transcription->crm_activity_id = $noteId;
$transcription->save();
} catch (Exception $e) {
Sentry::captureException($e);
}
}
/*
* @inheritdoc
*/
public function updateRecord(string $objectType, string $objectId, array $data, array $headers = []): void
{
$payload = [
'properties' => $data,
];
try {
switch ($objectType) {
case FieldData::OBJECT_OPPORTUNITY:
$this->client->getNewInstance()->crm()->deals()->basicApi()->update($objectId, $payload);
break;
case FieldData::OBJECT_CONTACT:
$this->client->getNewInstance()->crm()->contacts()->basicApi()->update($objectId, $payload);
break;
case Fi...
|
PhpStorm
|
faVsco.js – Service.php
|
NULL
|
9148
|
|
9147
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Code changed:
Hide
Sync Changes
Hide This Notification
7
48
1
33
1
Previous Highlighted Error
Next Highlighted Error
<?php
namespace Jiminny\Services\Crm\Hubspot;
use Carbon\Carbon;
use Exception;
use Generator;
use GuzzleHttp\Exception\RequestException;
use Illuminate\Support\Facades\Cache;
use InvalidArgumentException;
use Jiminny\Contracts\Repositories\TeamRepository;
use Jiminny\Contracts\Services\Crm\ClientInterface;
use Jiminny\Contracts\Services\Crm\FetchRelatedActivityInterface;
use Jiminny\Contracts\Services\Crm\LayoutManagementInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesInterface;
use Jiminny\Contracts\Services\Crm\Provider\HubspotInterface;
use Jiminny\Contracts\Services\Crm\RemoteEntityLookupInterface;
use Jiminny\Contracts\Services\Crm\RemoteEntityManipulationInterface;
use Jiminny\Contracts\Services\Crm\SavePlaybackLinkToCrmInterface;
use Jiminny\Contracts\Services\Crm\SendSummaryToCrmInterface;
use Jiminny\Contracts\Services\Crm\SettingsInterface;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Contracts\Services\Crm\SyncCrmMetadataInterface;
use Jiminny\Contracts\Services\Crm\VerifyTaskExistsInterface;
use Jiminny\Exceptions\CrmException;
use Jiminny\Exceptions\HttpNotFoundException;
use Jiminny\Jobs\Crm\NoteObject;
use Jiminny\Models\Account;
use Jiminny\Models\Activity;
use Jiminny\Models\Contact;
use Jiminny\Models\Contracts\ActivityContract;
use Jiminny\Models\Crm\BusinessProcess;
use Jiminny\Models\Crm\Field;
use Jiminny\Models\Crm\FieldData;
use Jiminny\Models\Crm\Layout;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Participant;
use Jiminny\Models\Playbook;
use Jiminny\Models\SocialAccount;
use Jiminny\Models\Stage;
use Jiminny\Models\User;
use Jiminny\Repositories\Crm\CrmEntityRepository;
use Jiminny\Repositories\Crm\FieldRepository;
use Jiminny\Repositories\Crm\ProfileRepository;
use Jiminny\Repositories\ParticipantRepository;
use Jiminny\Services\Avatar\ProspectPhotoPathService;
use Jiminny\Services\Crm\BaseService;
use Jiminny\Services\Crm\Hubspot\Actions\SyncArchivedProfilesAction;
use Jiminny\Services\Crm\Hubspot\Fields\ValueNormalizer;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\OpportunitySyncTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\SyncCrmEntitiesTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\SyncFieldsTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\WriteCrmTrait;
use Jiminny\Services\Crm\MatchDomainByEmailInterface;
use Jiminny\Services\Crm\OpportunitySyncStrategyResolver;
use Jiminny\Services\Crm\ResolveCompanyNameByEmailTrait;
use Jiminny\Utils\PlaybackUrlBuilder;
use Sentry;
use SevenShores\Hubspot\Exceptions\BadRequest;
use Throwable;
use UnexpectedValueException;
/**
* @phpstan-type CrmFieldDefinition array{
* name: string,
* label: string,
* description: string,
* type: string,
* fieldType: string,
* hidden: bool,
* showCurrencySymbol: bool,
* options: array<array{
* id: string,
* label: string,
* value?: string,
* }
*/
class Service extends BaseService implements
HubspotInterface,
SyncCrmEntitiesInterface,
SyncCrmMetadataInterface,
SendSummaryToCrmInterface,
MatchDomainByEmailInterface,
SavePlaybackLinkToCrmInterface,
RemoteEntityManipulationInterface,
FetchRelatedActivityInterface,
LayoutManagementInterface,
SettingsInterface,
MatchCrmEntitiesInterface,
RemoteEntityLookupInterface,
VerifyTaskExistsInterface
{
use ResolveCompanyNameByEmailTrait;
use SyncCrmEntitiesTrait;
use WriteCrmTrait;
use SyncFieldsTrait;
use OpportunitySyncTrait;
private const int ENGAGEMENT_BODY_MAX_LENGTH = 65536;
private const string LOG_DATE_FORMAT = 'Y-m-d H:i:s';
private const int BATCH_UPDATE_LIMIT = 100;
private const string TEN_SECONDLY_ROLLING_POLICY = 'TEN_SECONDLY_ROLLING';
private const int TEN_SECONDLY_ROLLING_LIMIT = 10;
private const string CALLS_SEARCH_ENDPOINT = '[URL_WITH_CREDENTIALS] ClientInterface|Client
*/
protected $client;
protected OpportunitySyncStrategyResolver $opportunitySyncStrategyResolver;
protected CrmEntityRepository $crmEntityRepository;
protected ProspectPhotoPathService $prospectPhotoPathService;
private SyncFieldAction $syncFieldAction;
private PayloadBuilder $payloadBuilder;
private SyncRelatedActivityManager $syncRelatedActivityManager;
private SyncArchivedProfilesAction $syncArchivedProfilesAction;
private WebhookSyncBatchProcessor $batchProcessor;
public function __construct(
Client $client,
SyncFieldAction $syncFieldAction,
PayloadBuilder $payloadBuilder,
ProspectPhotoPathService $prospectPhotoPathService,
SyncArchivedProfilesAction $syncArchivedProfilesAction,
WebhookSyncBatchProcessor $batchProcessor,
) {
parent::__construct();
$this->client = $client;
$this->syncFieldAction = $syncFieldAction;
$this->prospectPhotoPathService = $prospectPhotoPathService;
$this->payloadBuilder = $payloadBuilder;
$this->syncArchivedProfilesAction = $syncArchivedProfilesAction;
$this->batchProcessor = $batchProcessor;
$this->opportunitySyncStrategyResolver = app(OpportunitySyncStrategyResolver::class, [
'client' => $this->client,
]);
$this->syncRelatedActivityManager = app(SyncRelatedActivityManager::class, [
'client' => $this->client,
'payloadBuilder' => $this->payloadBuilder,
'logger' => $this->logger,
]);
$this->crmEntityRepository = app(CrmEntityRepository::class);
$this->dealFieldsService = app(DealFieldsService::class);
}
public function getDisplayName(): string
{
return 'HubSpot';
}
protected function getOAuthAccount(User $user): ?SocialAccount
{
// In this case, the Account Owner is always the connection for any API operations.
$owner = $user->team->owner;
return $owner->getSocialAccount(SocialAccount::PROVIDER_HUBSPOT);
}
public function getClient(): Client
{
/** @var Client */
return $this->client;
}
/**
* Convert raw field data into a format compatible with CRM APIs.
*
* @param bool $internal Direction of the conversion.
* True is pulling from CRM, false normalize before sending to CRM.
*/
public function normalizeValue(string $fieldType, string $fieldValue, bool $internal = false): string
{
return ValueNormalizer::normalize(
fieldType: $fieldType,
fieldValue: $fieldValue,
isInbound: $internal,
);
}
/**
* @inheritdoc
*/
public function getDefaultFields(string $activityType): array
{
$fields = [];
if ($activityType === Playbook::ACTIVITY_TYPE_TASK) {
$defaultFields = FieldDefinitions::defaultTaskFields();
// This lazy creates these fields if not already setup.
foreach ($defaultFields as $defaultField) {
$fields[] = $this->config->fields()->firstOrCreate($defaultField);
}
}
return $fields;
}
/**
* @inheritdoc
*/
public function getDefaultActivityField(string $activityType): Field
{
/** @var Field $activityField */
$activityField = $this->config->fields()->where([
'crm_provider_id' => 'activityType',
'object_type' => $activityType,
])->first();
return $activityField;
}
/**
* @inheritdoc
*/
public function getSupportedPlaybookTypes(): array
{
return [Playbook::ACTIVITY_TYPE_TASK];
}
/**
* @inheritdoc
*/
public function getDefaultActivityLayoutFields(string $activityType, string $layoutType): array
{
$fields = [];
if ($activityType === Playbook::ACTIVITY_TYPE_TASK) {
// Outcome should always be provided calls/meetings.
$fieldData = [
[
'crm_provider_id' => $layoutType === Layout::TYPE_SOFTPHONE_SUMMARY ? 'disposition' : 'meetingOutcome',
'object_type' => Field::OBJECT_TASK,
],
];
foreach ($fieldData as $data) {
$field = $this->config->fields()->where($data)->first();
// Only add the field if it is created, which it should be.
if ($field) {
$fields[] = $field;
}
}
}
return $fields;
}
public function getDealInsightsFields(): array
{
return FieldDefinitions::dealInsightsFields();
}
protected function getDefaultFollowupLayoutFields(string $activityType): array
{
$fields = [];
$fieldRepo = app(FieldRepository::class);
$fieldData = FieldDefinitions::followupFieldsFilter();
foreach ($fieldData as $data) {
$field = $fieldRepo->findOneConfigurationFieldByProperties($this->config, $data);
// Only add the field if it is created, which it should be.
if ($field) {
$fields[] = $field;
}
}
return $fields;
}
/**
* @inheritdoc
*/
public function syncField(Field $field): void
{
switch ($field->object_type) {
case Field::OBJECT_ACCOUNT:
$crmField = $this->client->getInstance()->companyProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_CONTACT:
$crmField = $this->client->getInstance()->contactProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_OPPORTUNITY:
$crmField = $this->client->getInstance()->dealProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_TASK:
$this->syncSingleTaskField($field);
return;
default:
return;
}
$this->syncFieldAction->execute($field, $crmField->toArray());
}
/**
* @param array<array{
* id:string,
* label:string,
* value?:string
* }> $options
*
* @throws CrmException
*
* @return FieldData[]
*
*/
public function importPicklistValues(
Field $field,
array $options = [['id' => '', 'label' => '', 'value' => '']],
): array {
if (! empty($options[0]['id']) || ! empty($options[0]['value'])) {
// We already have the options, no need to fetch them again
return $this->importOptions($field, $options);
}
$options = [];
switch ($field->getObjectType()) {
case Field::OBJECT_ACCOUNT:
$options = $this->getClient()->fetchPropertyOptions('company', $field->getCrmProviderId());
break;
case Field::OBJECT_CONTACT:
$options = $this->getClient()->fetchPropertyOptions('contact', $field->getCrmProviderId());
break;
case Field::OBJECT_OPPORTUNITY:
// Hubspot has different endpoint for stages
$options = $this->getClient()->fetchOpportunityFieldOptions($field);
break;
case Field::OBJECT_TASK:
if ($field->getCrmProviderId() === 'disposition') {
$options = $this->getClient()->fetchDispositionFieldOptions();
} elseif (in_array($field->getCrmProviderId(), ['meetingOutcome', 'activityType'])) {
$options = $this->getClient()->fetchMeetingOutcomeFieldOptions($field);
}
break;
default:
$this->logger->warning('Invalid object type', [
'object_type' => $field->getObjectType(),
'field_id' => $field->getId(),
]);
throw new CrmException('Invalid object type');
}
return $this->importOptions($field, $options);
}
/**
* @inheritdoc
*/
public function importStages(?array $types = null, ?string $missingStageName = null): ?Stage
{
$missingStage = null;
try {
// Use the HubSpot API client instead of the SDK crmPipelines() method
$endpoint = self::getDealsPipelinesEndpoint();
$pipelinesResponse = $this->client->getInstance()->getClient()->request('GET', $endpoint);
$pipelines = $pipelinesResponse->data->results;
} catch (RequestException|BadRequest $exception) {
throw $exception;
}
foreach ($pipelines as $pipeline) {
$stages = [];
// We create a business process to contain the pipeline, and store all stages against it.
$p = ResponseNormalize::normalizePipeline($pipeline);
// Create/update business process for this pipeline
$businessProcess = $this->config->businessProcesses()->updateOrCreate([
'crm_provider_id' => $p['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($p['label'], 0, 150),
'type' => BusinessProcess::TYPE_OPPORTUNITY,
'is_selectable' => $p['active'],
]);
// A record type is really a clone of the business process, used to store which record uses which pipeline.
// Create/update record type clone
$this->config->recordTypes()->updateOrCreate([
'crm_provider_id' => $p['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($p['label'], 0, 150),
'is_selectable' => $p['active'],
'business_process_id' => $businessProcess->id ?? null,
]);
// Stages - fetch all existing stages upfront to avoid N+1 queries
$existingStages = $this->config->stages()
->withTrashed()
->where('type', Stage::TYPE_OPPORTUNITY)
->get()
->keyBy('crm_provider_id');
foreach ($p['stages'] as $dealStage) {
$s = ResponseNormalize::normalizeDealStage($dealStage);
/** @var ?Stage $existingStage */
$existingStage = $existingStages->get($s['id']);
// Restore soft-deleted stages that are now active in HubSpot
if ($existingStage?->trashed() && $s['active']) {
$existingStage->restore();
}
// Upsert stage (updates soft-deleted records without restoring them)
$stage = $this->config->stages()->withTrashed()->updateOrCreate([
'crm_provider_id' => $s['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($s['label'], 0, 50),
'label' => mb_strimwidth($s['label'], 0, 191),
'type' => Stage::TYPE_OPPORTUNITY,
'sequence' => $s['displayOrder'],
'is_selectable' => $s['active'],
'probability' => $s['probability'] * 100,
]);
if ($missingStageName === $s['id']) {
$missingStage = $stage;
}
$stages[] = $stage->id;
}
$businessProcess->stages()->sync($stages);
}
return $missingStage;
}
/**
* @inheritdoc
*/
public function syncOrganization(): void
{
try {
$endpoint = '[URL_WITH_CREDENTIALS]
*/
public function find(string $name, array $scopes): array
{
$count = $this->limit ?? 20;
$offset = $this->offset ?? 0;
/** @var array<int, array<string, mixed>> */
return Cache::remember(
key: $this->team->getId() . $name . $count . $offset,
ttl: 300,
callback: function () use ($name, $offset, $count): array {
$data = [];
// Use the new V3 API to find contacts based on additional fields.
foreach (['companies', 'contacts'] as $objectType) {
$endpoint = '[URL_WITH_CREDENTIALS]
*/
public function findOpportunities(?string $crmAccountId, ?string $crmContactId, ?int $userId = null): array
{
$data = [];
$ownerData = [];
$ownerId = null;
if ($crmAccountId === null) {
return $data;
}
if ($userId) {
$profileRepository = app(ProfileRepository::class);
$profile = $profileRepository->findProfileByUserId($this->config, $userId);
$ownerId = $profile instanceof Profile ? $profile->getCrmProviderId() : null;
}
$closedStages = $this->getClosedDealStages();
$payload = $this->payloadBuilder->generateOpportunitiesSearchPayload(
$this->config,
$crmAccountId,
$closedStages,
);
$results = $this->client->getPaginatedData($payload, 'deals');
foreach ($results['results'] as $object) {
$properties = $object['properties'];
$amount = null;
if (empty($properties['amount']) === false) {
$currency = $properties['deal_currency_code'] ?? $this->config->default_currency;
// Values can contain commas and any junk so strip them.
$value = (float) preg_replace('/[^\d.]/', '', $properties['amount']);
$amount = formatCurrency($value, $currency);
}
$businessProcess = $this->config
->businessProcesses()
->where('crm_provider_id', $properties['pipeline'])
->first();
if ($businessProcess === null) {
// Import it.
$stage = $this->importStages([Stage::TYPE_OPPORTUNITY], $properties['dealstage']);
$businessProcess = $this->config
->businessProcesses()
->where('crm_provider_id', $properties['pipeline'])
->first();
} else {
$stage = $businessProcess
->stages()
->where('crm_provider_id', $properties['dealstage'])
->where('type', Stage::TYPE_OPPORTUNITY)
->first();
if ($stage === null) {
// Import it.
$stage = $this->importStages(null, $properties['dealstage']);
}
}
$recordType = null;
if ($businessProcess) {
$recordType = $businessProcess->recordTypes()->first();
}
$isWon = in_array($properties['dealstage'], $closedStages['won']);
$isLost = in_array($properties['dealstage'], $closedStages['lost']);
$record = [
'crmId' => $object['id'],
'name' => $properties['dealname'] ?? 'Unknown Deal',
'value' => $amount,
'won' => $isWon,
'closed' => $isWon || $isLost,
'stage' => [
'id' => $stage?->getUuid() ?? '',
'name' => $stage?->getName() ?? '',
],
];
if ($recordType) {
$record += [
'recordType' => [
'id' => $recordType->id_string,
'name' => $recordType->name,
],
];
}
if ($ownerId && isset($properties['hubspot_owner_id']) && $properties['hubspot_owner_id'] === $ownerId) {
$ownerData[] = $record;
}
$data[] = $record;
}
if (! empty($ownerData)) {
return $ownerData;
}
return $data;
}
/**
* @inheritdoc
*/
public function getTasks(?string $objectType, string $objectId, ?string $opportunityId): array
{
$data = [];
switch ($objectType) {
case 'contact':
$hsObject = 'contact';
break;
case 'account':
$hsObject = 'company';
break;
default:
// This is a hack to prioritise and override a contact/company with a deal.
if ($opportunityId) {
$hsObject = 'deal';
$objectId = $opportunityId;
} else {
throw new InvalidArgumentException('Object type not supported.');
}
}
$engagementTypes = ['meetings', 'tasks'];
foreach ($engagementTypes as $engagementType) {
$payload = $this->payloadBuilder->getLinkToTaskPayload($hsObject, $objectId, $engagementType);
$this->logger->info('[HubSpot] CRM Search requested', [
'request' => $payload,
]);
$engagements = $this->client->getPaginatedData($payload, $engagementType);
foreach ($engagements['results'] as $engagement) {
if ($engagementType == 'meetings') {
$title = $engagement['properties']['hs_meeting_title'] ?? 'Scheduled meeting';
} elseif ($engagementType == 'tasks') {
$title = $engagement['properties']['hs_task_subject'];
} else {
$title = 'Scheduled meeting';
}
$data[] = [
'crmId' => $engagement['id'],
'subject' => $title,
'due' => $engagement['properties']['hs_timestamp'],
'type' => $engagement['properties']['hs_activity_type'] ?? null,
];
}
}
usort($data, function ($item1, $item2) {
return $item2['due'] <=> $item1['due'];
});
return $data;
}
/**
* Try to find CRM Objects using email address
*
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
$contactProperties = [
'email',
'firstname',
'lastname',
'country',
'phone',
'mobilephone',
'jobtitle',
'hubspot_owner_id',
'associatedcompanyid',
'photo',
];
$contact = null;
$account = null;
try {
$hsContact = $this->getClient()->getContactByEmail($email, $contactProperties);
if ($hsContact) {
$contact = $this->importContact($hsContact);
$account = $contact->account;
}
$data = $this->convertCrmData($contact, $account, $userId);
return ! empty(array_filter($data)) ? $data : null;
} catch (BadRequest $e) {
$this->logger->warning('[HubSpot] Search failed', [
'team_id' => $this->team->getId(),
'search_identifier' => $email,
'reason' => $e->getMessage(),
]);
}
return null;
}
public function getDomain(string $email): ?string
{
return $this->getDomainFromEmail($email);
}
/**
* Try to find CRM objects using domain name of the email address
*
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByDomain(string $domain, ?int $userId = null): ?array
{
$companyName = $domain;
// Try to find a company matching their email domain.
$companyProperties = [
'country',
'phone',
'name',
'hs_avatar_filemanager_key',
'industry',
'hubspot_owner_id',
'domain',
];
try {
$hsAccounts = $this->client
->getInstance()
->companies()
->searchByDomain($companyName, $companyProperties);
} catch (Throwable $e) {
$this->logger->info('[HubSpot] Search failed', [
'error' => $e->getMessage(),
'domain' => $domain,
]);
return null;
}
$account = null;
// If there are multiple accounts, don't guess, we'll ask later.
if (\count($hsAccounts->data->results) === 1) {
// Persist this remote object.
$account = $this->syncAccount($hsAccounts->data->results[0]->companyId);
}
$data = $this->convertCrmData(null, $account, $userId);
return ! empty(array_filter($data)) ? $data : null;
}
/**
* @return array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
protected function convertCrmData(?Contact $contact, ?Account $account, ?int $userId = null): array
{
$countryCode = null;
if ($contact && $contact->country_code) {
$countryCode = $contact->country_code;
} elseif ($account && $account->country_code) {
$countryCode = $account->country_code;
}
try {
$hsOpportunities = $this->findOpportunities(
$account ? $account->crm_provider_id : null,
$contact ? $contact->crm_provider_id : null,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
// If there are multiple opportunities, don't guess, we'll ask later.
$opportunity = null;
$stage = null;
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
}
protected function getCacheKey(string $object, ?int $userId = null): ?string
{
$key = $this->team->getId() . $object;
$keySuffix = $this->getOwnerKeySuffix($userId);
return $key . $keySuffix;
}
private function getOwnerKeySuffix(?int $userId = null): string
{
return $userId === null ? '' : (string) $userId;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
if (str_contains($phone, '**')) {
return null;
}
// trim all whitespaces if present so the lookup doesn't fail
$phone = str_replace(' ', '', $phone);
// Check if the user is internal.
if ($this->isPhoneNumberOfTeamMember($phone)) {
return null;
}
$response = $this->searchForPhoneNumber($phone);
if (empty($response)) {
return null;
}
// This would ideally importContact instead but the response type differs.
$contact = $this->findAndSyncContact($response['results'][0]['id']);
if (! $contact instanceof Contact) {
return null;
}
$account = $contact->account;
$countryCode = $contact->country_code ?? $account->country_code ?? null;
try {
$hsOpportunities = $this->findOpportunities(
$account?->crm_provider_id,
$contact->crm_provider_id,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
$opportunity = null;
$stage = null;
try {
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
} catch (Exception $e) {
$this->logger->debug('[HubSpot] Opportunity failed to sync.', [
'reason' => $e->getMessage(),
]);
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
}
private function isPhoneNumberOfTeamMember(string $phone): bool
{
$teamRepository = app(TeamRepository::class);
$user = $teamRepository->findTeamMemberByPhone($this->team, $phone);
if ($user instanceof User) {
return true;
}
return false;
}
private function findAndSyncContact(string $crmId): ?Contact
{
try {
return $this->syncContact($crmId);
} catch (Exception $exception) {
$this->logger->info('[HubSpot] Phone match failed', [
'reason' => $exception->getMessage(),
]);
return null;
}
}
private function hasResults(array $response): bool
{
return isset($response['total']) && is_numeric($response['total']) && $response['total'] > 0;
}
private function searchForPhoneNumber(string $phone): array
{
// Normalizes the provided phone number for the API search.
$normalizedPhone = $this->normalizePhoneNumber($phone);
$payload = $this->payloadBuilder->generatePhoneSearchPayload($normalizedPhone);
$this->logger->info('[HubSpot] Phone match search triggered', [
'phone' => $phone,
'normalizedPhone' => $normalizedPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($normalizedPhone, $payload);
if (! $this->hasResults($response)) {
$nationalPhone = preg_replace('/\D/', '', phone_national(null, $phone));
$payload = $this->payloadBuilder->generatePhoneSearchPayload($nationalPhone);
$this->logger->info('[HubSpot] Phone match national number search triggered', [
'phone' => $phone,
'nationalPhone' => $nationalPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($phone, $payload);
}
if (! $this->hasResults($response)) {
$payload = $this->payloadBuilder->generatePhoneSearchPayload($normalizedPhone, true);
$this->logger->info('[HubSpot] Phone match alternative search triggered', [
'phone' => $phone,
'normalizedPhone' => $normalizedPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($phone, $payload);
}
return $this->hasResults($response) ? $response : [];
}
private function handlePhoneSearchRequest(string $phone, array $payload): array
{
$endpoint = '[URL_WITH_CREDENTIALS] null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
// Don't waste time searching for single character strings.
if (\strlen($name) <= 1) {
return null;
}
$cacheKey = $this->getCacheKey($name, $userId);
$result = Cache::remember($cacheKey, 60, function () use ($name, $userId) {
$payload = $this->payloadBuilder->generateSearchContactsByNamePayload(
$name,
$this->getContactFields()
);
$hsContacts = $this->client->getPaginatedData($payload, 'contact');
if (empty($hsContacts['results'])) {
return false;
}
$contact = $this->importContact($hsContacts['results'][0]);
if ($contact === null) {
return false;
}
$account = $contact->account;
$countryCode = $contact->country_code ?? $account->country_code ?? null;
try {
$hsOpportunities = $this->findOpportunities(
$account ? $account->crm_provider_id : null,
$contact->crm_provider_id,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
$opportunity = null;
$stage = null;
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
});
return is_array($result) ? $result : null;
}
private function convertActivityAssociations(Activity $activity): array
{
return [
'contactIds' => $this->getParticipantsIds($activity),
'companyIds' => $activity->hasAccount() ? [$activity->account->crm_provider_id] : [],
'dealIds' => $activity->hasOpportunity() ? [$activity->opportunity->crm_provider_id] : [],
'ownerIds' => [],
];
}
private function getParticipantsIds(Activity $activity): array
{
$attendees = [];
$participantRepository = app(ParticipantRepository::class);
$participants = $participantRepository->getParticipantsWhoEnteredMeeting($activity);
foreach ($participants as $participant) {
if ($participant->user_id || $participant->isCoach()) {
continue;
}
$contact = $participant->contact()->first();
if ($contact && $contact->crm_provider_id) {
$attendees[] = $contact->crm_provider_id;
} else {
if (! empty($participant->name)) {
$attendeeData = $this->fetchMissingAttendeeInfo($participant);
}
if (! empty($attendeeData['id'])) {
$attendees[] = $attendeeData['id'];
}
}
}
if ($activity->hasContact()) {
$attendees[] = $activity->contact->crm_provider_id;
}
return array_unique($attendees);
}
private function fetchMissingAttendeeInfo(Participant $participant): array
{
// Check if we need to look inside an account context.
$activity = $participant->getActivity();
$companyId = $activity->hasAccount() ? $activity->getAccount()->crm_provider_id : null;
// First check the local data.
/** @var Contact[] $contacts */
$contacts = $this->team->contacts()
->with('account')
->where('name', $participant->name)
->whereNotNull('email')
->get();
foreach ($contacts as $contact) {
// If we have a company in scope, check the contact is associated to it.
if (
$companyId !== null
&& ($contact->account_id === null || $companyId !== $contact->account->crm_provider_id)
) {
continue;
}
return [
'id' => $contact->crm_provider_id,
'email' => $contact->email,
];
}
$payload = $this->generateNameSearchPayload($participant->name, 0, 20);
try {
$response = $this->client->getNewInstance()->crm()->contacts()->searchApi()->doSearch($payload);
// TODO add some logic to choose the most suitable contact if multiple
foreach ($response['results'] as $object) {
$properties = $object['properties'];
if (empty($object['properties']) === false) {
// Check the company matches the contact.
// Todo: Move this check inside the API search.
if ($companyId !== null && $companyId !== $properties['associatedcompanyid']) {
continue;
}
return [
'id' => $object['id'],
'email' => $properties['email'],
];
}
}
} catch (Exception $e) {
$this->logger->warning('[' . $this->getDisplayName() . '] Search failed', [
'teamId' => $this->team->id_string,
'request' => $payload,
'reason' => $e->getMessage(),
]);
}
return [];
}
/**
* Store transcripts as note engagement.
*
* @throws Exception
*/
public function createTranscriptNotes(Activity $activity): void
{
// For HS no need to check if Crm profile - Log Notes field is enabled
// We only check if store_transcript toggle is enabled on crm profile.
$engagement = [
'active' => true,
'ownerId' => $this->profile->crm_provider_id,
'timestamp' => $activity->created_at->tz($activity->user->timezone)->getTimestamp() * 1000,
'type' => 'NOTE',
];
// Generate activity transcription.
$transcriptionData = $this->generateTranscription($activity);
// Truncate Notes with max notes length because transcription text could be very long.
$transcripts = mb_strimwidth($transcriptionData, 0, static::ENGAGEMENT_BODY_MAX_LENGTH);
$metadata = [
'body' => $transcripts,
];
$associations = $this->convertActivityAssociations($activity);
try {
$hsEngagement = $this->client
->getInstance()
->engagements()
->create($engagement, $associations, $metadata);
$this->logCrmEngagementManipulation(self::ACTION_CREATE, $engagement, $metadata, $associations);
$noteId = $hsEngagement->data->engagement->id;
// Store crm logged id in transcription.
$transcription = $activity->getTranscription();
$transcription->crm_activity_id = $noteId;
$transcription->save();
} catch (Exception $e) {
Sentry::captureException($e);
}
}
/*
* @inheritdoc
*/
public function updateRecord(string $objectType, string $objectId, array $data, array $headers = []): void
{
$payload = [
'properties' => $data,
];
try {
switch ($objectType) {
case FieldData::OBJECT_OPPORTUNITY:
$this->client->getNewInstance()->crm()->deals()->basicApi()->update($objectId, $payload);
break;
case FieldData::OBJECT_CONTACT:
$this->client->getNewInstance()->crm()->contacts()->basicApi()->update($objectId, $payload);
break;
case Fi...
|
PhpStorm
|
faVsco.js – Service.php
|
NULL
|
9147
|
|
9146
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
8
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Jiminny\Contracts\Services\Crm\ConnectionStateInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesWithCacheInterface;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\ApplicationException;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Psr\Log\LoggerInterface;
class CachedCrmServiceDecorator implements MatchCrmEntitiesWithCacheInterface
{
private ?ServiceInterface $crmService = null;
private ProspectCache $prospectCache;
private LoggerInterface $logger;
private ?Configuration $configuration;
public function __construct(
ProspectCache $prospectCache,
LoggerInterface $logger
) {
$this->prospectCache = $prospectCache;
$this->logger = $logger;
$this->configuration = null;
}
public function setCrmService(?ServiceInterface $crmService = null): void
{
$this->crmService = $crmService;
}
public function setConfiguration(Configuration $configuration): void
{
$this->configuration = $configuration;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
if (! filter_var($email, FILTER_VALIDATE_EMAIL)) {
$this->logger->warning('[Prospect match] Invalid email address', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_EMAIL,
'identifier' => $email,
]);
// The email address of the prospect is invalid.
// Return null, so we can try to match by phone or name.
return null;
}
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_EMAIL,
identifierValue: $email,
userId: $userId
);
}
public function matchByDomain(string $email, ?int $userId = null): ?array
{
if (! $this->crmService instanceof MatchDomainByEmailInterface) {
$this->logger->info('[Prospect match] Service does not support matching by domain', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'crm' => $this->crmService?->getDisplayName() ?? 'Not set',
'email' => $email,
]);
return null;
}
$domain = $this->crmService->getDomain($email);
if (empty($domain)) {
$this->logger->info('[Prospect match] Empty domain name', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'email' => $email,
]);
return null;
}
$this->logger->info('[Prospect match] Resolved company domain from email', [
'email' => $email,
'domain' => $domain,
]);
$configuration = $this->getConfiguration();
// try the cache
$cachedValue = $this->prospectCache->findDomainMatch(
configuration: $configuration,
identifier: $domain,
userId: $userId
);
if ($cachedValue !== null) {
return $cachedValue;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]);
$apiResult = $this->crmService->matchByDomain(domain: $domain, userId: $userId);
if (empty($apiResult)) {
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]
);
// cache the miss with empty prospect data
$apiResult = [null, null, null, null, null, null];
}
$this->prospectCache->set(
configuration: $configuration,
identifier: $domain,
prospectData: $apiResult,
userId: $userId
);
return $apiResult;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => 'name',
'identifier' => $name,
]);
return null;
}
return $this->crmService->matchByName(
name: $name,
userId: $userId
);
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_PHONE,
identifierValue: $phone,
identifierSecondaryValue: $rawPhoneNumber,
userId: $userId
);
}
/**
* @throws ApplicationException
*/
private function matchByProspectIdentifier(
string $identifierType,
string $identifierValue,
?string $identifierSecondaryValue = null,
?int $userId = null,
): ?array {
$configuration = $this->getConfiguration();
$profile = $this->crmService->profile ?? null;
// Normalize phone number BEFORE cache lookup
if ($identifierType === ProspectCache::PROSPECT_TYPE_PHONE) {
$identifierValue = $this->prospectCache->normalizePhoneNumber($identifierValue);
}
$prospectData = $this->prospectCache->findByProspectIdentifier(
configuration: $configuration,
profile: $profile,
identifierType: $identifierType,
identifierValue: $identifierValue,
userId: $userId,
crmService: $this->crmService
);
if ($prospectData !== null) {
$this->logger->info('[Prospect match] Cache / local search hit', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (empty(array_filter($prospectData))) {
$this->logger->info('[Prospect match] cached empty result - no API calls, try next matching method', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
/**
* @IMPORTANT This is a cached empty result, i.e. there's no prospect with this email.
* We cache the empty result, so we don't keep querying the database and the API
* for non-existing prospects.
* However, we need to return null from this method
* in order to trigger the next matching method (e.g. matchByPhone or matchByName).
* This is because an array with null values is not considered empty.
*/
return null;
}
return $prospectData;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
return null;
}
/** @var 'email'|'phone' $identifierType */
$apiResult = match($identifierType) {
ProspectCache::PROSPECT_TYPE_EMAIL => $this->crmService->matchExactlyByEmail(
email: $identifierValue,
userId: $userId
),
ProspectCache::PROSPECT_TYPE_PHONE => $this->crmService->matchByPhone(
phone: $identifierValue,
rawPhoneNumber: $identifierSecondaryValue,
userId: $userId
),
};
$cachedResult = $apiResult;
if (empty($apiResult)) {
// In case the result is null or an empty array,
// cache the missing prospect, so we don't keep calling the API
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]
);
$cachedResult = [null, null, null, null, null, null];
}
// Set the cache even if the result is empty,
// so we don't keep querying the database and the API
$this->prospectCache->set($configuration, $identifierValue, $cachedResult, $userId);
return $apiResult;
}
private function isConnected(): bool
{
if ($this->crmService instanceof ConnectionStateInterface) {
return $this->crmService->isConnected();
}
return $this->crmService !== null;
}
/**
* @throws ApplicationException
*/
private function getConfiguration(): Configuration
{
if ($this->configuration) {
return $this->configuration;
}
if ($this->crmService?->getConfiguration()) {
return $this->crmService->getConfiguration();
}
throw new ApplicationException('Missing team configuration. Cannot set team prospect cache');
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9146
|
|
9145
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
8
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Jiminny\Contracts\Services\Crm\ConnectionStateInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesWithCacheInterface;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\ApplicationException;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Psr\Log\LoggerInterface;
class CachedCrmServiceDecorator implements MatchCrmEntitiesWithCacheInterface
{
private ?ServiceInterface $crmService = null;
private ProspectCache $prospectCache;
private LoggerInterface $logger;
private ?Configuration $configuration;
public function __construct(
ProspectCache $prospectCache,
LoggerInterface $logger
) {
$this->prospectCache = $prospectCache;
$this->logger = $logger;
$this->configuration = null;
}
public function setCrmService(?ServiceInterface $crmService = null): void
{
$this->crmService = $crmService;
}
public function setConfiguration(Configuration $configuration): void
{
$this->configuration = $configuration;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
if (! filter_var($email, FILTER_VALIDATE_EMAIL)) {
$this->logger->warning('[Prospect match] Invalid email address', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_EMAIL,
'identifier' => $email,
]);
// The email address of the prospect is invalid.
// Return null, so we can try to match by phone or name.
return null;
}
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_EMAIL,
identifierValue: $email,
userId: $userId
);
}
public function matchByDomain(string $email, ?int $userId = null): ?array
{
if (! $this->crmService instanceof MatchDomainByEmailInterface) {
$this->logger->info('[Prospect match] Service does not support matching by domain', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'crm' => $this->crmService?->getDisplayName() ?? 'Not set',
'email' => $email,
]);
return null;
}
$domain = $this->crmService->getDomain($email);
if (empty($domain)) {
$this->logger->info('[Prospect match] Empty domain name', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'email' => $email,
]);
return null;
}
$this->logger->info('[Prospect match] Resolved company domain from email', [
'email' => $email,
'domain' => $domain,
]);
$configuration = $this->getConfiguration();
// try the cache
$cachedValue = $this->prospectCache->findDomainMatch(
configuration: $configuration,
identifier: $domain,
userId: $userId
);
if ($cachedValue !== null) {
return $cachedValue;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]);
$apiResult = $this->crmService->matchByDomain(domain: $domain, userId: $userId);
if (empty($apiResult)) {
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]
);
// cache the miss with empty prospect data
$apiResult = [null, null, null, null, null, null];
}
$this->prospectCache->set(
configuration: $configuration,
identifier: $domain,
prospectData: $apiResult,
userId: $userId
);
return $apiResult;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => 'name',
'identifier' => $name,
]);
return null;
}
return $this->crmService->matchByName(
name: $name,
userId: $userId
);
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_PHONE,
identifierValue: $phone,
identifierSecondaryValue: $rawPhoneNumber,
userId: $userId
);
}
/**
* @throws ApplicationException
*/
private function matchByProspectIdentifier(
string $identifierType,
string $identifierValue,
?string $identifierSecondaryValue = null,
?int $userId = null,
): ?array {
$configuration = $this->getConfiguration();
$profile = $this->crmService->profile ?? null;
// Normalize phone number BEFORE cache lookup
if ($identifierType === ProspectCache::PROSPECT_TYPE_PHONE) {
$identifierValue = $this->prospectCache->normalizePhoneNumber($identifierValue);
}
$prospectData = $this->prospectCache->findByProspectIdentifier(
configuration: $configuration,
profile: $profile,
identifierType: $identifierType,
identifierValue: $identifierValue,
userId: $userId,
crmService: $this->crmService
);
if ($prospectData !== null) {
$this->logger->info('[Prospect match] Cache / local search hit', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (empty(array_filter($prospectData))) {
$this->logger->info('[Prospect match] cached empty result - no API calls, try next matching method', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
/**
* @IMPORTANT This is a cached empty result, i.e. there's no prospect with this email.
* We cache the empty result, so we don't keep querying the database and the API
* for non-existing prospects.
* However, we need to return null from this method
* in order to trigger the next matching method (e.g. matchByPhone or matchByName).
* This is because an array with null values is not considered empty.
*/
return null;
}
return $prospectData;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
return null;
}
/** @var 'email'|'phone' $identifierType */
$apiResult = match($identifierType) {
ProspectCache::PROSPECT_TYPE_EMAIL => $this->crmService->matchExactlyByEmail(
email: $identifierValue,
userId: $userId
),
ProspectCache::PROSPECT_TYPE_PHONE => $this->crmService->matchByPhone(
phone: $identifierValue,
rawPhoneNumber: $identifierSecondaryValue,
userId: $userId
),
};
$cachedResult = $apiResult;
if (empty($apiResult)) {
// In case the result is null or an empty array,
// cache the missing prospect, so we don't keep calling the API
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]
);
$cachedResult = [null, null, null, null, null, null];
}
// Set the cache even if the result is empty,
// so we don't keep querying the database and the API
$this->prospectCache->set($configuration, $identifierValue, $cachedResult, $userId);
return $apiResult;
}
private function isConnected(): bool
{
if ($this->crmService instanceof ConnectionStateInterface) {
return $this->crmService->isConnected();
}
return $this->crmService !== null;
}
/**
* @throws ApplicationException
*/
private function getConfiguration(): Configuration
{
if ($this->configuration) {
return $this->configuration;
}
if ($this->crmService?->getConfiguration()) {
return $this->crmService->getConfiguration();
}
throw new ApplicationException('Missing team configuration. Cannot set team prospect cache');
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9145
|
|
9144
|
PhostormINavigareCodeLaravelKeractorFV faVsco.js?9 PhostormINavigareCodeLaravelKeractorFV faVsco.js?9 masterProiect•JiminnyDebugcommand.ong© SyncFieldAction.php© SyncRelatedActivityl(C) WebhookSvncBatch!v D IntegrationApp>D Accessors>@Api|>@ Config>ODTO•Urilters>@ Jobs> C ProspectSearchStrat> 0 ServiceTraits© DataClient.phrc) Decorareacuiviv.oho© LocalSearch.php0LocalSearchintertacelC) RemoteSearch.oho(C) Service,ohov M listeners(c) Convert LeadActivitieC) PurdeLookunCache.rlM Metadatal1 MiarationPipedrivem Salesforce• M SieldeM OnnortunitvMatcher> @ OpportunitySyncStra>@ ProspectSearchStrat) M ServiceTraitc© Client.php© DecorateActivity.phpT DeleteObjectsTrait.pl© FieldDefinitions.php© PayloadBuilder.php(c) Profile.php© QueryBuilder.php© QuervHandler.phpC) @uerviterator.phr© QuervResults.phrn. DeleteCrmEntityraic.ongo kematcnactiviyoncrmobjectbetach.on© CheckAndRetryRemoteMatch.php(C) MatchActivityCrmData.ongermacuivilyservice.png© CrmObjectsResolver.phpC) ProviderkateLimiter.php©)Paginationeonnig.pnpclass cachedcrmservicebecorator 1mpLements Matchcrmentitlesw1thcachelntertace56 C76 CX(c) Service.oho@ SvncBatchRedisServi 147M Traits© BaseClient.php146 E148149C BaseService.oho•) CachedCrmServiceDecc(C) CountrvCodeResolver.o8 CrmActivitvProviderinte(C) CrmActivitvService nhol@ CrmConfiauration Settind@ CmObienteRecolver nh, 156 €t >public function setconfiguration(Configuration Sconfiguration): voidt...* @return null/arrayfLead|null,Account/null,Opportunity|null,Contac+/null.scagelnuet,string|nullpublic function matchExactlyByEmail(string Semail, ?int SuserId = null): ?arrayif (! filter var(Semail.filter: FILTER_VALIDATE EMAIL)){Sthis->logger->warning('[Prospect match] Invalid email address', [ndentztier tyoel'identifier' => Semaill=Prospectlache::PruSPEL/ TYPE ChAlL,/The email address of the prospect is invalid.I/ Return null, so we can try to match by phone or name.return null:return $this->matchByProspectIdentifieridentifierTvne: ProsnectCache: PROSPECT TYPE EMATIIidentifierValue: Semail.userid• Susertdlpublic function matchByDomain(string $email, ?int $userId = null): ?array{...}* @return null/arrayfleadlnull.Acdbunt/nutt,Upporcunzzu nuul,conracr nuuuStagelnultstrinalnullpublic function matchByName(string Sname. ?int SuserId = null): 2arrav{...?4 SF jiminny@localhost]A HS_local [jiminny@localhost]# console [PKol)A console [EU]"Uace".L"Inu,or May 2020 14.21.15 6Ml"Jn"concenc-lyoe. apolicacionison.charser=uct-o.n"Transfer-Encoding": ["chunked"]."CF-Ray":"9t80deb8dbo0dcsa-S0F""Strict-Transport-Security":["max-aqe=31536000: includeSubDomains: preload"].acceot-encodino""server-timing": ["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\","x-content-type-options": ["nosniff"],"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],"Set-Cookie":["__cf_bm=StUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxT07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Renont-To".f"y"endnoints"."url\":\"https:|\/\V/a.nel.cloudflare.com\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgl\"group\":\"cf-nel\".\"max_age\":604800}"],"NEL": ["125A console [STAGING][2026-05-07 14:21:15] local.INF0: [Hubspot] DEBUG Getting headers {M X19 A Vsuccess_traccion.0.0lr"report to\":|"cf-nel\"."max age| ":604800}"]."Server": ["cloudflare"]}} {"correlation_1d": "95256555-ec98-4541-D92a-adta/Sboyead","trace_10":C/AD8565-905t-4604-9405-0e5b551e55455suppont Dally• om len100% 12Fri 8 May 15:10:47AskJiminnyReportActivityServiceTest vCascadeHubspot Rate LimitingHubSpot Rate Limit ReInvestigating Rate Lin+0 ..There is no cache laver at the decorator level for name matching — it deleaates straiaht to the service4. getPaginatedData fetches ALL pagesmatchbyName calls getPaginateddata) not the generator wnich eagerly tetches all pages or contact results. generatesearchContactsByNamePay Load uses CONTAINS_TOKEN which can match many contacts - every page is a separate API request.5. usleep(sdelay) is per-job, not per-team_ HubspotPaginationservice.php:gscelay = schis→>calcularevelay.nmicroseconasPaginationConfia.php:10public const int SEARCH RPS LIMIT = 4:The delay is 1/4 * 1,000,000 = 250ms per request per job instance . With N jobs running in parallel, the effective rate is 4 * N RPS tromHubSpot's perspective. HubSpot's search endpoint limit is 5 RPS globally per portal - with just 2 concurrent jobs the limit is already blown,Summary of Root CausesIssueImpactNo rate limiting coordination across jobsMultiple workers hit HubSpot simultaneously, multiplying RPSmatchByName has no decorator-level cacheSame name searched repeatedly by different jobsmatchRuName cache TTl is onlv 60c sconed to useridiCache busts frequently, same contact name searched N timesgetPaginatedData fetches all pages eagerlyOne name search = multiple API requestsmatchByName → findOpportunities chained API callOne participant match = 2+ paginated searchesShouldRelinique doesn't dedunlicate acrocs activitiecN activities dispatched = N independent concurrent jobsSuaaested ImprovementsImmediate / Hiah Imoact.1. Add decorator-level cachina for matchßwame in GachedCrmServiceDecorator — scone the cache kev to confiald + name (not userid ) witha longer TTL (e.a. 5 min). Contact names don't change per-user2. Use the generator instead of getPaginatedData in matchByName — stop after first result with ->current() , don't fetch all pages.3. Implement a team-scoped Redis rate limiter (e.g. sliding window) in HubspotPaginationService:: executeSearchRequest() to enforce ≤5PDS acroce all workers for the came nortal.4. Catch GuzzleHttp\Exception\ClientException with 429 and implement exponential backoft — currently the exception propagates unhandlecand the job retries after [30, 90, 180] seconds, but the root cause (other jobs) is still running.5. Increase matchBvName cache TTL and remove userid from cache key — a contact named "John Smith" is the same regardless of which repsearched for themwIf we would place match&vName to CachedCrmService Decorator same asC° AdantiveW Windsurf Toams 64-14/267 charc 8 line hroakc) UTF.8io 4 spaces...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9144
|
|
9143
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
PhostormVIewINavigarecodeLaravelKeractorFV faVsco.js°9 master kProledeyJiminnyDebugcommand.ong© SyncFieldAction.phpn. DeleteCrmEntityraic.ongo kematcnactiviyoncrmobjectbetach.org© CheckAndRetryRemoteMatch.php(C) MatchActivityermData.ong© SyncRelatedActivityl© ermacuivityservice.pnp(C) WebhookSvncBatch!v D IntegrationApp© CrmObjectsResolver.php©)Paginationeonnig.pnp>D Accessors>@Api|class cachedcrmserviceDecorator 1mplements Matchcrment1t1esw1thlachelntertaceprivate function matchByProspectIdentifier(>@ Config>ODTO•Urilters>@ Jobs_ Prospectsearchstrau>U service I raitsc) Daraclient.oho© DecorateActivity-php 249C)LocalSearch.ohvU LocalSearchintertace 247C) RemoteSearch.oho(C) Service,ohov hUisteners© ConvertLeadActivitie 25%© PurgeLookupCache.f 252M MetadatalN MiarationPipedrivem Salesforce• M SieldeM OnnortunitvMatchernOpportunitysynestd>@ ProspectSearchStrat 24dM ServiceTraitc© Client.php© DecorateActivity-pnp 263T DeleteObjectsTrait.pl 264© FieldDefinitions.phpPavloacbullder.ono© Profile.phpC) @uervBullder.php267268© QuervHandler.phpC) @uerviterator.phr© QuervResults.phr(c) Service.oho© SyncBatchRedisServi 273M TraitsC. Baseclient. ohoC BaseService.ohoCachedCrmServiceDecc 27-© CountryCodeResolver.pl 278d CrmActivitvProviderinte: 275(C) CrmActivitvService nhol© CrmConfigurationSetting 29r© CrmObjectsResolver.ph| 29grecurn nutl,recurn sprospeccbacaSthis->logger->info('(Prospect match] Cache miss, calling the API'. [ndenultiercype= Sidentiflerlype,'identifier' => SidentifierValue.1):if (4 Sthis->isConnected@) {Sthis->Logger->info('[Prospect match) Service is not connected, remote search is currently not ava:o"identifier tyoe= Sidentifiertvoelreturn null./** @var 'email''phone' SidentifierType */CaniRocin+ = matchcidentifienTvne)4Prosnectlache:•prospect typp ematl => Sthic-scnmSenvice-matchFyact1vRvFmai1dProsnectlache:•prospsct typs pHONg -> Sthic-scnmSenvice-smatchRvPhone^phone: $identifierValue,rawrnonenumber: s1dencltlersecondaryvalue.ucontd. Cucont.ScachedResult = SapiResult:if (empty(SapiResult)) {n case the result is null or an emoty arrav.cache the missina prospect, so we don't keen callina the APtSthis->loagen->info("Prosoect matchi APt returned emoty result, cachina the miss with emoty orosnect data'.."identifier tvnel => SidentifiertvnelIidentifien!= Cident-fienValte.4 SF jiminny@localhost]A HS_local [jiminny@localhost]# console [PKol)A console [EU]A console [STAGING][2026-05-07 14:21:15] local.INF0: [Hubspot] DEBUG Getting headers {M X19 A V"neaders".?"Uace"."Inu,or May 2020 14.21.15 6Ml"Jn"concent-lvoe. "apolicacionison charser=utt-on"Transfer-Encoding": ["chunked"]."CF-Ray":"9t80deb8dbo0dcsa-S0F""Strict-Transport-Security":["max-aqe=31536000: includeSubDomains: preload"].acceot-encodino""server-timing": ["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\","x-content-type-options": ["nosniff"],"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],"Set-Cookie":["__cf_bm=StUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxT07-May-26 14:51:15 GMT; domain=.hubapi.com; Http0nly; Secure; SameSite=None"],"Renont-To".f"y"endnoints".\"url\":\"https:|\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgl\"group\":\"cf-nel\".\"max_age\":604800}"],"NEL": ["1\"success_fraction\":0.01,"report to\":"cf-nel\"."max age| ":604800}"]."Server": ["cloudflare"]}} {"correlation_1d": "95256555-ec98-4541-D92a-adta/Sboyead","trace_10":C/AD8565-905t-4604-9405-0e5b551e5545'suppont Dally• om len100% 12Fri 8 May 15:10:42AskJiminnyReportActivityServiceTest vCascadeHubspot Rate LimitingHubSpot Rate Limit ReInvestigating Rate Lin+0 ..There is no cache laver at the decorator level for name matchina — it deleaates straiaht to the service4. getPaginatedData fetches ALL pagesmatchbyName calls getPaginateddata) not the generator wnich eagerly tetches all pages or contact results. generatesearchContactsByNamePay Load uses CONTAINS_TOKEN which can match many contacts - every page is a separate API request.5. usleep(sdelay) is per-job, not per-team_ HubspotPaginationservice.php:sgscelay = schis→>calcularevelay.nmicroseconasPaginationConfia.php:10public const int SEARCH RPS LIMIT = 4:The delay is 1/4 * 1,000,000 = 250ms per request per job instance . With N jobs running in parallel, the effective rate is 4 * N RPS tromHubSpot's perspective. HubSpot's search endpoint limit is 5 RPS globally per portal - with just 2 concurrent jobs the limit is already blown,Summary of Root CausesIssueImpactNo rate limiting coordination across jobsMultiple workers hit HubSpot simultaneously, multiplying RPSmatchByName has no decorator-level cacheSame name searched repeatedly by different jobsmatchRuName cache TTl is onlv 60c sconed to useridiCache busts frequently, same contact name searched N timesgetPaginatedData fetches all pages eagerlyOne name search = multiple API requestsmatchByName → findOpportunities chained API callOne participant match = 2+ paginated searchesShouldRelinique doesn't dedunlicate acrocs activitiecN activities dispatched = N independent concurrent jobsSuggested mprovementsImmediate / Hiah Imoact.1. Add decorator-level cachina for matchßwame in GachedCrmServiceDecorator — scone the cache kev to confiald + name (not userid ) witha longer TTL (e.a. 5 min). Contact names don't change per-user2. Use the generator instead of getPaginatedData in matchByName — stop after first result with ->current() , don't fetch all pages.3. Implement a team-scoped Redis rate limiter (e.g. sliding window) in HubspotPaginationService:: executeSearchRequest() to enforce ≤5PpS acrocc all workers for the came nortal.i4. Catch GuzzleHttp\Exception\ClientException with 429 and implement exponential backoft — currently the exception propagates unhandlecand the job retries after [30, 90, 180] seconds, but the root cause (other jobs) is still running.5. Increase matchBvName cache TTL and remove userid from cache key — a contact named "John Smith" is the same regardless of which repsearched for themIf we would place match&vName to CachedCrmService Decorator same asC° AdantiveWN Windsurf Toams 196.22 UTF.8io 4 spaces...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9143
|
|
9142
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
8
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Jiminny\Contracts\Services\Crm\ConnectionStateInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesWithCacheInterface;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\ApplicationException;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Psr\Log\LoggerInterface;
class CachedCrmServiceDecorator implements MatchCrmEntitiesWithCacheInterface
{
private ?ServiceInterface $crmService = null;
private ProspectCache $prospectCache;
private LoggerInterface $logger;
private ?Configuration $configuration;
public function __construct(
ProspectCache $prospectCache,
LoggerInterface $logger
) {
$this->prospectCache = $prospectCache;
$this->logger = $logger;
$this->configuration = null;
}
public function setCrmService(?ServiceInterface $crmService = null): void
{
$this->crmService = $crmService;
}
public function setConfiguration(Configuration $configuration): void
{
$this->configuration = $configuration;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
if (! filter_var($email, FILTER_VALIDATE_EMAIL)) {
$this->logger->warning('[Prospect match] Invalid email address', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_EMAIL,
'identifier' => $email,
]);
// The email address of the prospect is invalid.
// Return null, so we can try to match by phone or name.
return null;
}
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_EMAIL,
identifierValue: $email,
userId: $userId
);
}
public function matchByDomain(string $email, ?int $userId = null): ?array
{
if (! $this->crmService instanceof MatchDomainByEmailInterface) {
$this->logger->info('[Prospect match] Service does not support matching by domain', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'crm' => $this->crmService?->getDisplayName() ?? 'Not set',
'email' => $email,
]);
return null;
}
$domain = $this->crmService->getDomain($email);
if (empty($domain)) {
$this->logger->info('[Prospect match] Empty domain name', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'email' => $email,
]);
return null;
}
$this->logger->info('[Prospect match] Resolved company domain from email', [
'email' => $email,
'domain' => $domain,
]);
$configuration = $this->getConfiguration();
// try the cache
$cachedValue = $this->prospectCache->findDomainMatch(
configuration: $configuration,
identifier: $domain,
userId: $userId
);
if ($cachedValue !== null) {
return $cachedValue;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]);
$apiResult = $this->crmService->matchByDomain(domain: $domain, userId: $userId);
if (empty($apiResult)) {
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]
);
// cache the miss with empty prospect data
$apiResult = [null, null, null, null, null, null];
}
$this->prospectCache->set(
configuration: $configuration,
identifier: $domain,
prospectData: $apiResult,
userId: $userId
);
return $apiResult;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => 'name',
'identifier' => $name,
]);
return null;
}
return $this->crmService->matchByName(
name: $name,
userId: $userId
);
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_PHONE,
identifierValue: $phone,
identifierSecondaryValue: $rawPhoneNumber,
userId: $userId
);
}
/**
* @throws ApplicationException
*/
private function matchByProspectIdentifier(
string $identifierType,
string $identifierValue,
?string $identifierSecondaryValue = null,
?int $userId = null,
): ?array {
$configuration = $this->getConfiguration();
$profile = $this->crmService->profile ?? null;
// Normalize phone number BEFORE cache lookup
if ($identifierType === ProspectCache::PROSPECT_TYPE_PHONE) {
$identifierValue = $this->prospectCache->normalizePhoneNumber($identifierValue);
}
$prospectData = $this->prospectCache->findByProspectIdentifier(
configuration: $configuration,
profile: $profile,
identifierType: $identifierType,
identifierValue: $identifierValue,
userId: $userId,
crmService: $this->crmService
);
if ($prospectData !== null) {
$this->logger->info('[Prospect match] Cache / local search hit', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (empty(array_filter($prospectData))) {
$this->logger->info('[Prospect match] cached empty result - no API calls, try next matching method', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
/**
* @IMPORTANT This is a cached empty result, i.e. there's no prospect with this email.
* We cache the empty result, so we don't keep querying the database and the API
* for non-existing prospects.
* However, we need to return null from this method
* in order to trigger the next matching method (e.g. matchByPhone or matchByName).
* This is because an array with null values is not considered empty.
*/
return null;
}
return $prospectData;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
return null;
}
/** @var 'email'|'phone' $identifierType */
$apiResult = match($identifierType) {
ProspectCache::PROSPECT_TYPE_EMAIL => $this->crmService->matchExactlyByEmail(
email: $identifierValue,
userId: $userId
),
ProspectCache::PROSPECT_TYPE_PHONE => $this->crmService->matchByPhone(
phone: $identifierValue,
rawPhoneNumber: $identifierSecondaryValue,
userId: $userId
),
};
$cachedResult = $apiResult;
if (empty($apiResult)) {
// In case the result is null or an empty array,
// cache the missing prospect, so we don't keep calling the API
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]
);
$cachedResult = [null, null, null, null, null, null];
}
// Set the cache even if the result is empty,
// so we don't keep querying the database and the API
$this->prospectCache->set($configuration, $identifierValue, $cachedResult, $userId);
return $apiResult;
}
private function isConnected(): bool
{
if ($this->crmService instanceof ConnectionStateInterface) {
return $this->crmService->isConnected();
}
return $this->crmService !== null;
}
/**
* @throws ApplicationException
*/
private function getConfiguration(): Configuration
{
if ($this->configuration) {
return $this->configuration;
}
if ($this->crmService?->getConfiguration()) {
return $this->crmService->getConfiguration();
}
throw new ApplicationException('Missing team configuration. Cannot set team prospect cache');
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9142
|
|
9141
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
8
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Jiminny\Contracts\Services\Crm\ConnectionStateInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesWithCacheInterface;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\ApplicationException;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Psr\Log\LoggerInterface;
class CachedCrmServiceDecorator implements MatchCrmEntitiesWithCacheInterface
{
private ?ServiceInterface $crmService = null;
private ProspectCache $prospectCache;
private LoggerInterface $logger;
private ?Configuration $configuration;
public function __construct(
ProspectCache $prospectCache,
LoggerInterface $logger
) {
$this->prospectCache = $prospectCache;
$this->logger = $logger;
$this->configuration = null;
}
public function setCrmService(?ServiceInterface $crmService = null): void
{
$this->crmService = $crmService;
}
public function setConfiguration(Configuration $configuration): void
{
$this->configuration = $configuration;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
if (! filter_var($email, FILTER_VALIDATE_EMAIL)) {
$this->logger->warning('[Prospect match] Invalid email address', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_EMAIL,
'identifier' => $email,
]);
// The email address of the prospect is invalid.
// Return null, so we can try to match by phone or name.
return null;
}
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_EMAIL,
identifierValue: $email,
userId: $userId
);
}
public function matchByDomain(string $email, ?int $userId = null): ?array
{
if (! $this->crmService instanceof MatchDomainByEmailInterface) {
$this->logger->info('[Prospect match] Service does not support matching by domain', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'crm' => $this->crmService?->getDisplayName() ?? 'Not set',
'email' => $email,
]);
return null;
}
$domain = $this->crmService->getDomain($email);
if (empty($domain)) {
$this->logger->info('[Prospect match] Empty domain name', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'email' => $email,
]);
return null;
}
$this->logger->info('[Prospect match] Resolved company domain from email', [
'email' => $email,
'domain' => $domain,
]);
$configuration = $this->getConfiguration();
// try the cache
$cachedValue = $this->prospectCache->findDomainMatch(
configuration: $configuration,
identifier: $domain,
userId: $userId
);
if ($cachedValue !== null) {
return $cachedValue;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]);
$apiResult = $this->crmService->matchByDomain(domain: $domain, userId: $userId);
if (empty($apiResult)) {
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]
);
// cache the miss with empty prospect data
$apiResult = [null, null, null, null, null, null];
}
$this->prospectCache->set(
configuration: $configuration,
identifier: $domain,
prospectData: $apiResult,
userId: $userId
);
return $apiResult;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => 'name',
'identifier' => $name,
]);
return null;
}
return $this->crmService->matchByName(
name: $name,
userId: $userId
);
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_PHONE,
identifierValue: $phone,
identifierSecondaryValue: $rawPhoneNumber,
userId: $userId
);
}
/**
* @throws ApplicationException
*/
private function matchByProspectIdentifier(
string $identifierType,
string $identifierValue,
?string $identifierSecondaryValue = null,
?int $userId = null,
): ?array {
$configuration = $this->getConfiguration();
$profile = $this->crmService->profile ?? null;
// Normalize phone number BEFORE cache lookup
if ($identifierType === ProspectCache::PROSPECT_TYPE_PHONE) {
$identifierValue = $this->prospectCache->normalizePhoneNumber($identifierValue);
}
$prospectData = $this->prospectCache->findByProspectIdentifier(
configuration: $configuration,
profile: $profile,
identifierType: $identifierType,
identifierValue: $identifierValue,
userId: $userId,
crmService: $this->crmService
);
if ($prospectData !== null) {
$this->logger->info('[Prospect match] Cache / local search hit', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (empty(array_filter($prospectData))) {
$this->logger->info('[Prospect match] cached empty result - no API calls, try next matching method', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
/**
* @IMPORTANT This is a cached empty result, i.e. there's no prospect with this email.
* We cache the empty result, so we don't keep querying the database and the API
* for non-existing prospects.
* However, we need to return null from this method
* in order to trigger the next matching method (e.g. matchByPhone or matchByName).
* This is because an array with null values is not considered empty.
*/
return null;
}
return $prospectData;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
return null;
}
/** @var 'email'|'phone' $identifierType */
$apiResult = match($identifierType) {
ProspectCache::PROSPECT_TYPE_EMAIL => $this->crmService->matchExactlyByEmail(
email: $identifierValue,
userId: $userId
),
ProspectCache::PROSPECT_TYPE_PHONE => $this->crmService->matchByPhone(
phone: $identifierValue,
rawPhoneNumber: $identifierSecondaryValue,
userId: $userId
),
};
$cachedResult = $apiResult;
if (empty($apiResult)) {
// In case the result is null or an empty array,
// cache the missing prospect, so we don't keep calling the API
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]
);
$cachedResult = [null, null, null, null, null, null];
}
// Set the cache even if the result is empty,
// so we don't keep querying the database and the API
$this->prospectCache->set($configuration, $identifierValue, $cachedResult, $userId);
return $apiResult;
}
private function isConnected(): bool
{
if ($this->crmService instanceof ConnectionStateInterface) {
return $this->crmService->isConnected();
}
return $this->crmService !== null;
}
/**
* @throws ApplicationException
*/
private function getConfiguration(): Configuration
{
if ($this->configuration) {
return $this->configuration;
}
if ($this->crmService?->getConfiguration()) {
return $this->crmService->getConfiguration();
}
throw new ApplicationException('Missing team configuration. Cannot set team prospect cache');
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9141
|
|
9140
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
8
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Jiminny\Contracts\Services\Crm\ConnectionStateInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesWithCacheInterface;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\ApplicationException;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Psr\Log\LoggerInterface;
class CachedCrmServiceDecorator implements MatchCrmEntitiesWithCacheInterface
{
private ?ServiceInterface $crmService = null;
private ProspectCache $prospectCache;
private LoggerInterface $logger;
private ?Configuration $configuration;
public function __construct(
ProspectCache $prospectCache,
LoggerInterface $logger
) {
$this->prospectCache = $prospectCache;
$this->logger = $logger;
$this->configuration = null;
}
public function setCrmService(?ServiceInterface $crmService = null): void
{
$this->crmService = $crmService;
}
public function setConfiguration(Configuration $configuration): void
{
$this->configuration = $configuration;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
if (! filter_var($email, FILTER_VALIDATE_EMAIL)) {
$this->logger->warning('[Prospect match] Invalid email address', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_EMAIL,
'identifier' => $email,
]);
// The email address of the prospect is invalid.
// Return null, so we can try to match by phone or name.
return null;
}
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_EMAIL,
identifierValue: $email,
userId: $userId
);
}
public function matchByDomain(string $email, ?int $userId = null): ?array
{
if (! $this->crmService instanceof MatchDomainByEmailInterface) {
$this->logger->info('[Prospect match] Service does not support matching by domain', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'crm' => $this->crmService?->getDisplayName() ?? 'Not set',
'email' => $email,
]);
return null;
}
$domain = $this->crmService->getDomain($email);
if (empty($domain)) {
$this->logger->info('[Prospect match] Empty domain name', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'email' => $email,
]);
return null;
}
$this->logger->info('[Prospect match] Resolved company domain from email', [
'email' => $email,
'domain' => $domain,
]);
$configuration = $this->getConfiguration();
// try the cache
$cachedValue = $this->prospectCache->findDomainMatch(
configuration: $configuration,
identifier: $domain,
userId: $userId
);
if ($cachedValue !== null) {
return $cachedValue;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]);
$apiResult = $this->crmService->matchByDomain(domain: $domain, userId: $userId);
if (empty($apiResult)) {
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]
);
// cache the miss with empty prospect data
$apiResult = [null, null, null, null, null, null];
}
$this->prospectCache->set(
configuration: $configuration,
identifier: $domain,
prospectData: $apiResult,
userId: $userId
);
return $apiResult;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => 'name',
'identifier' => $name,
]);
return null;
}
return $this->crmService->matchByName(
name: $name,
userId: $userId
);
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_PHONE,
identifierValue: $phone,
identifierSecondaryValue: $rawPhoneNumber,
userId: $userId
);
}
/**
* @throws ApplicationException
*/
private function matchByProspectIdentifier(
string $identifierType,
string $identifierValue,
?string $identifierSecondaryValue = null,
?int $userId = null,
): ?array {
$configuration = $this->getConfiguration();
$profile = $this->crmService->profile ?? null;
// Normalize phone number BEFORE cache lookup
if ($identifierType === ProspectCache::PROSPECT_TYPE_PHONE) {
$identifierValue = $this->prospectCache->normalizePhoneNumber($identifierValue);
}
$prospectData = $this->prospectCache->findByProspectIdentifier(
configuration: $configuration,
profile: $profile,
identifierType: $identifierType,
identifierValue: $identifierValue,
userId: $userId,
crmService: $this->crmService
);
if ($prospectData !== null) {
$this->logger->info('[Prospect match] Cache / local search hit', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (empty(array_filter($prospectData))) {
$this->logger->info('[Prospect match] cached empty result - no API calls, try next matching method', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
/**
* @IMPORTANT This is a cached empty result, i.e. there's no prospect with this email.
* We cache the empty result, so we don't keep querying the database and the API
* for non-existing prospects.
* However, we need to return null from this method
* in order to trigger the next matching method (e.g. matchByPhone or matchByName).
* This is because an array with null values is not considered empty.
*/
return null;
}
return $prospectData;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
return null;
}
/** @var 'email'|'phone' $identifierType */
$apiResult = match($identifierType) {
ProspectCache::PROSPECT_TYPE_EMAIL => $this->crmService->matchExactlyByEmail(
email: $identifierValue,
userId: $userId
),
ProspectCache::PROSPECT_TYPE_PHONE => $this->crmService->matchByPhone(
phone: $identifierValue,
rawPhoneNumber: $identifierSecondaryValue,
userId: $userId
),
};
$cachedResult = $apiResult;
if (empty($apiResult)) {
// In case the result is null or an empty array,
// cache the missing prospect, so we don't keep calling the API
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]
);
$cachedResult = [null, null, null, null, null, null];
}
// Set the cache even if the result is empty,
// so we don't keep querying the database and the API
$this->prospectCache->set($configuration, $identifierValue, $cachedResult, $userId);
return $apiResult;
}
private function isConnected(): bool
{
if ($this->crmService instanceof ConnectionStateInterface) {
return $this->crmService->isConnected();
}
return $this->crmService !== null;
}
/**
* @throws ApplicationException
*/
private function getConfiguration(): Configuration
{
if ($this->configuration) {
return $this->configuration;
}
if ($this->crmService?->getConfiguration()) {
return $this->crmService->getConfiguration();
}
throw new ApplicationException('Missing team configuration. Cannot set team prospect cache');
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9140
|
|
9139
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
PhostormNavigatecodeLaravelKeractorFV faVsco.js?9 master kProledeyJiminnyDebugcommand.ong© SyncFieldAction.phpn. DeleteCrmEntityraic.ongo kematcnactiviyoncrmobjectbetach.org© SyncRelatedActivityl(C) WebhookSvncBatch!© CheckAndRetryRemoteMatch.php© MatchActivityCrmData.phpv D IntegrationApp>D Accessors>@Api|>@ Config>ODTO© CrmObjectsResolver.php•Urilters>@ Jobs> @ ProspectSearchStrat 4oo>U service I raitsc) Daraclient.oho© DecorateActivitv.pho 195C)LocalSearch.ohv@ LocalSearchInterface 1Y0C) RemoteSearch.oho(C) Service,ohov hUisteners© ConvertLeadActivitie 20%C) PurdeLookunCache.rlM Metadatal209N Miarationm Pinedrivem Salesforce• M SieldeM OnnortunitvMatcher> OpportunitySyncStra)M ProcnectSearchStratM ServiceTraitc© Client.php© DecorateActivity.php [EMAIL]© FieldDefinitions.php© PayloadBuilder.php(e) Profile.php222© QueryBuilder.php© QuervHandler.phpC) @uerviterator.phr© QuervResults.phr224225226(c) Service.oho© SvncBatchRedisServM Traits230G BaseClient.phpC BaseService.oho(C) CountrvCodeResolver.o8 CrmActivitvProviderinte) CrmActivitvService nho.(C) CrmConfiauration Settinc@ CrmOhiectcPecolver nh, 236(@ DefaultDrocnertSearchs 240class Crmactiv1tyServiceprivate function updateParticipantsCnmData(A1V5 A.neturn ShestMatch:private function shouldPerformLookup(Participant $participant, Team $team): bool{...}private function validateCrmConfiguration(Activity $activity): void{...}private function getBestMatch(?array $matchedRecords, ?array $matchedDomainRecords): array{...}private function findCrmRecords(Participant $participant, Activity $activity): ?arraySrecoros = null"if (Sparticipant->hasEmailAddress@) $Srecords = sthis->decorator->matchExactvBvEmamoemail: soarticinant->qetEma1.Addressor.userid: Sactivity->qetuser@->qetdolifemntv(Srecords) && Snarticinant->aetPhoneNumberor lez nulib<Srecords = Sthis->decoraton->matchRvPhonednhone: Soarticinant->aetPhoneNumberolucenld• Cactivitv->aetliceno->aetTdloif (empty($records) && $participant->getName• |== null) {Gnoronde= C+hic-sdeconaton-smatchRvMameflname: $participant->getNameO.userId: Sactivity->getUser->getIdO.private function shouldSkipParticipant(Participant Sparticipant): boolf...?supoont Dally • now100% 12Fri 8 May 15:09:45AskJiminnyReportActivityServiceTest v+0 ..= custom.log X4 SF jiminny@localhost]A HS_local [jiminny@localhost]# console [PKol)A console [EU]A console [STAGING][2026-05-07 14:21:15] local.INF0: [Hubspot] DEBUG Getting headers {M X19 A V"neaders".?"Uace".L"Inu,or May 2020 14.21.15 6MlJn"concent-lvoe. "apolicacionison charser=utt-on"Transter-encoding":"chunked","CF-Ray":"9t80deb8dbo0dcsa-S0F""Strict-Transport-Secur1ty":"max-aqe=31536008* 1ncLudeSubDomains: preload"),acceot-encodino""server-timing": ["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\","x-content-type-options": ["nosniff"],"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],"Set-Cookie":["__cf_bm=StUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxT07-May-26 14:51:15 GMT; domain=.hubapi.com; Http0nly; Secure; SameSite=None"],"Renont-To".f"y"endnoints".\"url\":\"https:|\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgl\"group\":\"cf-nel\".\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,reportco. "cr-nel,"max age| ":604800}"]."Server": ["cloudflare"]}} {"correlation_1d": "95256555-ec98-4541-D92a-adta/Sboyead","trace_10":C/AD8565-905t-4604-9405-0e5b551e5545'CascadeHubspot Rate LimitingHubSpot Rate Limit ReInvestigating Rate LinThere is no cache laver at the decorator level for name matching — it deleaates straiaht to the service4. getPaginatedData fetches ALL pagesmatchbyName calls getPaginateddata) not the generator wnich eagerly tetches all pages or contact results. generatesearchContactsByNamePay Load uses CONTAINS_TOKEN which can match many contacts - every page is a separate API request.5. usleep(sdelay) is per-job, not per-team_ HubspotPaginationservice.php:gscelay = schis→>calcularevelay.nmicroseconasPaginationConfia.php:10public const int SEARCH RPS LIMIT = 4:The delay is 1/4 * 1,000,000 = 250ms per request per job instance . With N jobs running in parallel, the effective rate is 4 * N RPS tromHubSpot's perspective. HubSpot's search endpoint limit is 5 RPS globally per portal - with just 2 concurrent jobs the limit is already blown,Summary of Root CausesIssueImpactNo rate limiting coordination across jobsMultiple workers hit HubSpot simultaneously, multiplying RPSmatchByName has no decorator-level cacheSame name searched repeatedly by different jobsmatchRuName cache TTl is onlv 60c sconed to useridiCache busts frequently, same contact name searched N timesgetPaginatedData fetches all pages eagerlyOne name search = multiple API requestsmatchByName → find0pportunities chained APl callOne participant match = 2+ paginated searchesShouldRelinique doesn't dedunlicate acrocs activitiecN activities dispatched = N independent concurrent jobsSuggested mprovementsImmediate / Hiah Imoact.1. Add decorator-level cachina for matchßwame in GachedCrmServiceDecorator — scone the cache kev to confiald + name (not userid ) witha longer TTL (e.a. 5 min). Contact names don't change per-user2. Use the generator instead of getPaginatedData in matchByName — stop after first result with ->current() , don't fetch all pages.3. Implement a team-scoped Redis rate limiter (e.g. sliding window) in HubspotPaginationService:: executeSearchRequest() to enforce ≤5PDS acroce all workere for the came nortal4. Catch GuzzleHttp\Exception\ClientException with 429 and implement exponential backoft — currently the exception propagates unhandlecand the job retries after [30, 90, 180] seconds, but the root cause (other jobs) is still running.5. Increase matchBvName cache TTL and remove userid from cache key — a contact named "John Smith" is the same regardless of which repsearched for themr.al .wAsk anvthing (&+-bC° AdantiveWN Windsurf Toams 215-27 UTF.8io 4 spaces...
|
PhpStorm
|
faVsco.js – CrmActivityService.php
|
NULL
|
9139
|
|
9138
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
8
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Jiminny\Contracts\Services\Crm\ConnectionStateInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesWithCacheInterface;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\ApplicationException;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Psr\Log\LoggerInterface;
class CachedCrmServiceDecorator implements MatchCrmEntitiesWithCacheInterface
{
private ?ServiceInterface $crmService = null;
private ProspectCache $prospectCache;
private LoggerInterface $logger;
private ?Configuration $configuration;
public function __construct(
ProspectCache $prospectCache,
LoggerInterface $logger
) {
$this->prospectCache = $prospectCache;
$this->logger = $logger;
$this->configuration = null;
}
public function setCrmService(?ServiceInterface $crmService = null): void
{
$this->crmService = $crmService;
}
public function setConfiguration(Configuration $configuration): void
{
$this->configuration = $configuration;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
if (! filter_var($email, FILTER_VALIDATE_EMAIL)) {
$this->logger->warning('[Prospect match] Invalid email address', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_EMAIL,
'identifier' => $email,
]);
// The email address of the prospect is invalid.
// Return null, so we can try to match by phone or name.
return null;
}
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_EMAIL,
identifierValue: $email,
userId: $userId
);
}
public function matchByDomain(string $email, ?int $userId = null): ?array
{
if (! $this->crmService instanceof MatchDomainByEmailInterface) {
$this->logger->info('[Prospect match] Service does not support matching by domain', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'crm' => $this->crmService?->getDisplayName() ?? 'Not set',
'email' => $email,
]);
return null;
}
$domain = $this->crmService->getDomain($email);
if (empty($domain)) {
$this->logger->info('[Prospect match] Empty domain name', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'email' => $email,
]);
return null;
}
$this->logger->info('[Prospect match] Resolved company domain from email', [
'email' => $email,
'domain' => $domain,
]);
$configuration = $this->getConfiguration();
// try the cache
$cachedValue = $this->prospectCache->findDomainMatch(
configuration: $configuration,
identifier: $domain,
userId: $userId
);
if ($cachedValue !== null) {
return $cachedValue;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]);
$apiResult = $this->crmService->matchByDomain(domain: $domain, userId: $userId);
if (empty($apiResult)) {
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]
);
// cache the miss with empty prospect data
$apiResult = [null, null, null, null, null, null];
}
$this->prospectCache->set(
configuration: $configuration,
identifier: $domain,
prospectData: $apiResult,
userId: $userId
);
return $apiResult;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => 'name',
'identifier' => $name,
]);
return null;
}
return $this->crmService->matchByName(
name: $name,
userId: $userId
);
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_PHONE,
identifierValue: $phone,
identifierSecondaryValue: $rawPhoneNumber,
userId: $userId
);
}
/**
* @throws ApplicationException
*/
private function matchByProspectIdentifier(
string $identifierType,
string $identifierValue,
?string $identifierSecondaryValue = null,
?int $userId = null,
): ?array {
$configuration = $this->getConfiguration();
$profile = $this->crmService->profile ?? null;
// Normalize phone number BEFORE cache lookup
if ($identifierType === ProspectCache::PROSPECT_TYPE_PHONE) {
$identifierValue = $this->prospectCache->normalizePhoneNumber($identifierValue);
}
$prospectData = $this->prospectCache->findByProspectIdentifier(
configuration: $configuration,
profile: $profile,
identifierType: $identifierType,
identifierValue: $identifierValue,
userId: $userId,
crmService: $this->crmService
);
if ($prospectData !== null) {
$this->logger->info('[Prospect match] Cache / local search hit', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (empty(array_filter($prospectData))) {
$this->logger->info('[Prospect match] cached empty result - no API calls, try next matching method', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
/**
* @IMPORTANT This is a cached empty result, i.e. there's no prospect with this email.
* We cache the empty result, so we don't keep querying the database and the API
* for non-existing prospects.
* However, we need to return null from this method
* in order to trigger the next matching method (e.g. matchByPhone or matchByName).
* This is because an array with null values is not considered empty.
*/
return null;
}
return $prospectData;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
return null;
}
/** @var 'email'|'phone' $identifierType */
$apiResult = match($identifierType) {
ProspectCache::PROSPECT_TYPE_EMAIL => $this->crmService->matchExactlyByEmail(
email: $identifierValue,
userId: $userId
),
ProspectCache::PROSPECT_TYPE_PHONE => $this->crmService->matchByPhone(
phone: $identifierValue,
rawPhoneNumber: $identifierSecondaryValue,
userId: $userId
),
};
$cachedResult = $apiResult;
if (empty($apiResult)) {
// In case the result is null or an empty array,
// cache the missing prospect, so we don't keep calling the API
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]
);
$cachedResult = [null, null, null, null, null, null];
}
// Set the cache even if the result is empty,
// so we don't keep querying the database and the API
$this->prospectCache->set($configuration, $identifierValue, $cachedResult, $userId);
return $apiResult;
}
private function isConnected(): bool
{
if ($this->crmService instanceof ConnectionStateInterface) {
return $this->crmService->isConnected();
}
return $this->crmService !== null;
}
/**
* @throws ApplicationException
*/
private function getConfiguration(): Configuration
{
if ($this->configuration) {
return $this->configuration;
}
if ($this->crmService?->getConfiguration()) {
return $this->crmService->getConfiguration();
}
throw new ApplicationException('Missing team configuration. Cannot set team prospect cache');
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9138
|
|
9137
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
1
5
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Illuminate\Support\Collection;
use Jiminny\Contracts\Repositories\TeamRepository;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\InvalidArgumentException;
use Jiminny\Exceptions\SocialAccountTokenInvalidException;
use Jiminny\Models\Account;
use Jiminny\Models\Activity;
use Jiminny\Models\Contact;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Participant;
use Jiminny\Models\Stage;
use Jiminny\Models\Team;
use Jiminny\Models\User;
use Jiminny\Services\ResolveTeamCrmConnection;
use Psr\Container\ContainerExceptionInterface;
use Psr\Container\NotFoundExceptionInterface;
use Psr\Log\LoggerInterface;
use Exception;
use Throwable;
class CrmActivityService
{
public function __construct(
private readonly TeamRepository $teamRepository,
private readonly CachedCrmServiceDecorator $decorator,
private readonly EmailHelper $emailHelper,
private readonly ResolveTeamCrmConnection $teamCrmResolver,
private readonly LoggerInterface $logger,
) {
}
/**
* Updates CRM data for an activity and its participants.
*
* NOTE: This method performs multiple database writes and should be called
* within a transaction by the caller to ensure atomicity.
*
* @param Activity $activity
* @param bool $remoteSearch
*
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
* @throws Exception
*/
public function updateCrmData(
Activity $activity,
bool $remoteSearch = false,
): void {
$crmService = null;
$participants = $activity->getParticipants();
$team = $activity->getTeam();
$prospectSearchStrategy = ProspectSearchStrategyFactory::match($team);
if ($prospectSearchStrategy->ignoreCrmMatchData()) {
$this->logger->info('[CrmActivityService] Ignoring crm data because of prospect strategy', [
'activity_id' => $activity->getId(),
'strategy' => get_class($prospectSearchStrategy),
]);
return;
}
if ($remoteSearch) {
try {
$crmService = $this->teamCrmResolver->resolveForTeam($team);
} catch (SocialAccountTokenInvalidException) {
$this->logger->warning('[CrmActivityService] CRM token expired, falling back to local search', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
]);
}
}
$records = $this->updateParticipantsCrmData(
team: $team,
activity: $activity,
participants: $participants,
crmService: $crmService,
);
if (! empty($records)) {
$activity->updateActivityCrmData($records);
}
$activity->refresh();
}
/**
* @param Collection<Participant> $participants
*
* @throws Exception
*
* @return array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}|array{}
*/
private function updateParticipantsCrmData(
Team $team,
Activity $activity,
Collection $participants,
?ServiceInterface $crmService = null,
): array {
$matchedRecords = [];
$matchedDomainRecords = [];
$this->validateCrmConfiguration($activity);
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
foreach ($participants as $participant) {
if ($this->shouldSkipParticipant($participant)) {
continue;
}
if (! $this->shouldPerformLookup($participant, $team)) {
$this->logger->info('[CrmActivityService] Email domain belongs to the team, skipping crm lookup', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
'email' => $participant->getEmailAddress(),
]);
$this->attachUserIfExists($participant, $team);
continue;
}
$records = $this->findCrmRecords($participant, $activity);
if (! empty($records)) {
$matchedRecords[] = $records;
} else {
$records = $this->findCrmDomainRecords(
crmService: $crmService,
participant: $participant,
activity: $activity,
);
if (! empty($records)) {
$matchedDomainRecords[] = $records;
}
}
if (empty($records)) {
continue;
}
try {
$activity->updateParticipantCrmData($records, $participant);
} catch (Throwable $ex) {
$this->logger->error('[CrmActivityService] Failed to update participant CRM data', [
'activity_id' => $activity->getId(),
'participant_id' => $participant->getId(),
'exception' => $ex->getMessage(),
]);
continue;
}
}
$bestMatch = $this->getBestMatch(
matchedRecords : $matchedRecords,
matchedDomainRecords: $matchedDomainRecords,
);
$this->logger->info('[CrmActivityService] CRM matching completed', [
'activity_id' => $activity->getId(),
'participants_processed' => $participants->count(),
'exact_matches' => count($matchedRecords),
'domain_matches' => count($matchedDomainRecords),
'best_match_found' => ! empty($bestMatch),
]);
return $bestMatch;
}
private function shouldPerformLookup(Participant $participant, Team $team): bool
{
if ($participant->hasEmailAddress()) {
return $this->emailHelper->shouldPerformLookup($team, $participant->getEmailAddress());
}
return true;
}
private function validateCrmConfiguration(Activity $activity): void
{
if ($activity->getCrm() === null) {
throw new InvalidArgumentException('Cannot find CRM configuration');
}
}
private function getBestMatch(?array $matchedRecords, ?array $matchedDomainRecords): array
{
return RecordSelector::pickBestFromLists($matchedRecords, $matchedDomainRecords);
}
private function findCrmRecords(Participant $participant, Activity $activity): ?array
{
$records = null;
if ($participant->hasEmailAddress()) {
$records = $this->decorator->matchExactlyByEmail(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
}
if (empty($records) && $participant->getPhoneNumber() !== null) {
$records = $this->decorator->matchByPhone(
phone: $participant->getPhoneNumber(),
userId: $activity->getUser()->getId(),
);
}
if (empty($records) && $participant->getName() !== null) {
$records = $this->decorator->matchByName(
name: $participant->getName(),
userId: $activity->getUser()->getId(),
);
}
return $records;
}
private function shouldSkipParticipant(Participant $participant): bool
{
return $participant->hasUser();
}
private function attachUserIfExists(Participant $participant, Team $team): void
{
if ($participant->hasEmailAddress() === false) {
return;
}
$user = $this->teamRepository->findActiveTeamMemberByEmail($team, $participant->getEmailAddress());
if ($user instanceof User) {
$participant->user_id = $user->getId();
$participant->save();
}
}
private function findCrmDomainRecords(
?ServiceInterface $crmService,
Participant $participant,
Activity $activity,
): array {
if ($participant->hasEmailAddress()) {
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
$records = $this->decorator->matchByDomain(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
if (! empty($records)) {
return $records;
}
}
return [];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CrmActivityService.php
|
NULL
|
9137
|
|
9136
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}...
|
PhpStorm
|
faVsco.js – CrmActivityService.php
|
NULL
|
9136
|
|
9135
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
1
5
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Illuminate\Support\Collection;
use Jiminny\Contracts\Repositories\TeamRepository;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\InvalidArgumentException;
use Jiminny\Exceptions\SocialAccountTokenInvalidException;
use Jiminny\Models\Account;
use Jiminny\Models\Activity;
use Jiminny\Models\Contact;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Participant;
use Jiminny\Models\Stage;
use Jiminny\Models\Team;
use Jiminny\Models\User;
use Jiminny\Services\ResolveTeamCrmConnection;
use Psr\Container\ContainerExceptionInterface;
use Psr\Container\NotFoundExceptionInterface;
use Psr\Log\LoggerInterface;
use Exception;
use Throwable;
class CrmActivityService
{
public function __construct(
private readonly TeamRepository $teamRepository,
private readonly CachedCrmServiceDecorator $decorator,
private readonly EmailHelper $emailHelper,
private readonly ResolveTeamCrmConnection $teamCrmResolver,
private readonly LoggerInterface $logger,
) {
}
/**
* Updates CRM data for an activity and its participants.
*
* NOTE: This method performs multiple database writes and should be called
* within a transaction by the caller to ensure atomicity.
*
* @param Activity $activity
* @param bool $remoteSearch
*
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
* @throws Exception
*/
public function updateCrmData(
Activity $activity,
bool $remoteSearch = false,
): void {
$crmService = null;
$participants = $activity->getParticipants();
$team = $activity->getTeam();
$prospectSearchStrategy = ProspectSearchStrategyFactory::match($team);
if ($prospectSearchStrategy->ignoreCrmMatchData()) {
$this->logger->info('[CrmActivityService] Ignoring crm data because of prospect strategy', [
'activity_id' => $activity->getId(),
'strategy' => get_class($prospectSearchStrategy),
]);
return;
}
if ($remoteSearch) {
try {
$crmService = $this->teamCrmResolver->resolveForTeam($team);
} catch (SocialAccountTokenInvalidException) {
$this->logger->warning('[CrmActivityService] CRM token expired, falling back to local search', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
]);
}
}
$records = $this->updateParticipantsCrmData(
team: $team,
activity: $activity,
participants: $participants,
crmService: $crmService,
);
if (! empty($records)) {
$activity->updateActivityCrmData($records);
}
$activity->refresh();
}
/**
* @param Collection<Participant> $participants
*
* @throws Exception
*
* @return array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}|array{}
*/
private function updateParticipantsCrmData(
Team $team,
Activity $activity,
Collection $participants,
?ServiceInterface $crmService = null,
): array {
$matchedRecords = [];
$matchedDomainRecords = [];
$this->validateCrmConfiguration($activity);
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
foreach ($participants as $participant) {
if ($this->shouldSkipParticipant($participant)) {
continue;
}
if (! $this->shouldPerformLookup($participant, $team)) {
$this->logger->info('[CrmActivityService] Email domain belongs to the team, skipping crm lookup', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
'email' => $participant->getEmailAddress(),
]);
$this->attachUserIfExists($participant, $team);
continue;
}
$records = $this->findCrmRecords($participant, $activity);
if (! empty($records)) {
$matchedRecords[] = $records;
} else {
$records = $this->findCrmDomainRecords(
crmService: $crmService,
participant: $participant,
activity: $activity,
);
if (! empty($records)) {
$matchedDomainRecords[] = $records;
}
}
if (empty($records)) {
continue;
}
try {
$activity->updateParticipantCrmData($records, $participant);
} catch (Throwable $ex) {
$this->logger->error('[CrmActivityService] Failed to update participant CRM data', [
'activity_id' => $activity->getId(),
'participant_id' => $participant->getId(),
'exception' => $ex->getMessage(),
]);
continue;
}
}
$bestMatch = $this->getBestMatch(
matchedRecords : $matchedRecords,
matchedDomainRecords: $matchedDomainRecords,
);
$this->logger->info('[CrmActivityService] CRM matching completed', [
'activity_id' => $activity->getId(),
'participants_processed' => $participants->count(),
'exact_matches' => count($matchedRecords),
'domain_matches' => count($matchedDomainRecords),
'best_match_found' => ! empty($bestMatch),
]);
return $bestMatch;
}
private function shouldPerformLookup(Participant $participant, Team $team): bool
{
if ($participant->hasEmailAddress()) {
return $this->emailHelper->shouldPerformLookup($team, $participant->getEmailAddress());
}
return true;
}
private function validateCrmConfiguration(Activity $activity): void
{
if ($activity->getCrm() === null) {
throw new InvalidArgumentException('Cannot find CRM configuration');
}
}
private function getBestMatch(?array $matchedRecords, ?array $matchedDomainRecords): array
{
return RecordSelector::pickBestFromLists($matchedRecords, $matchedDomainRecords);
}
private function findCrmRecords(Participant $participant, Activity $activity): ?array
{
$records = null;
if ($participant->hasEmailAddress()) {
$records = $this->decorator->matchExactlyByEmail(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
}
if (empty($records) && $participant->getPhoneNumber() !== null) {
$records = $this->decorator->matchByPhone(
phone: $participant->getPhoneNumber(),
userId: $activity->getUser()->getId(),
);
}
if (empty($records) && $participant->getName() !== null) {
$records = $this->decorator->matchByName(
name: $participant->getName(),
userId: $activity->getUser()->getId(),
);
}
return $records;
}
private function shouldSkipParticipant(Participant $participant): bool
{
return $participant->hasUser();
}
private function attachUserIfExists(Participant $participant, Team $team): void
{
if ($participant->hasEmailAddress() === false) {
return;
}
$user = $this->teamRepository->findActiveTeamMemberByEmail($team, $participant->getEmailAddress());
if ($user instanceof User) {
$participant->user_id = $user->getId();
$participant->save();
}
}
private function findCrmDomainRecords(
?ServiceInterface $crmService,
Participant $participant,
Activity $activity,
): array {
if ($participant->hasEmailAddress()) {
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
$records = $this->decorator->matchByDomain(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
if (! empty($records)) {
return $records;
}
}
return [];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CrmActivityService.php
|
NULL
|
9135
|
|
9134
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
1
5
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Illuminate\Support\Collection;
use Jiminny\Contracts\Repositories\TeamRepository;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\InvalidArgumentException;
use Jiminny\Exceptions\SocialAccountTokenInvalidException;
use Jiminny\Models\Account;
use Jiminny\Models\Activity;
use Jiminny\Models\Contact;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Participant;
use Jiminny\Models\Stage;
use Jiminny\Models\Team;
use Jiminny\Models\User;
use Jiminny\Services\ResolveTeamCrmConnection;
use Psr\Container\ContainerExceptionInterface;
use Psr\Container\NotFoundExceptionInterface;
use Psr\Log\LoggerInterface;
use Exception;
use Throwable;
class CrmActivityService
{
public function __construct(
private readonly TeamRepository $teamRepository,
private readonly CachedCrmServiceDecorator $decorator,
private readonly EmailHelper $emailHelper,
private readonly ResolveTeamCrmConnection $teamCrmResolver,
private readonly LoggerInterface $logger,
) {
}
/**
* Updates CRM data for an activity and its participants.
*
* NOTE: This method performs multiple database writes and should be called
* within a transaction by the caller to ensure atomicity.
*
* @param Activity $activity
* @param bool $remoteSearch
*
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
* @throws Exception
*/
public function updateCrmData(
Activity $activity,
bool $remoteSearch = false,
): void {
$crmService = null;
$participants = $activity->getParticipants();
$team = $activity->getTeam();
$prospectSearchStrategy = ProspectSearchStrategyFactory::match($team);
if ($prospectSearchStrategy->ignoreCrmMatchData()) {
$this->logger->info('[CrmActivityService] Ignoring crm data because of prospect strategy', [
'activity_id' => $activity->getId(),
'strategy' => get_class($prospectSearchStrategy),
]);
return;
}
if ($remoteSearch) {
try {
$crmService = $this->teamCrmResolver->resolveForTeam($team);
} catch (SocialAccountTokenInvalidException) {
$this->logger->warning('[CrmActivityService] CRM token expired, falling back to local search', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
]);
}
}
$records = $this->updateParticipantsCrmData(
team: $team,
activity: $activity,
participants: $participants,
crmService: $crmService,
);
if (! empty($records)) {
$activity->updateActivityCrmData($records);
}
$activity->refresh();
}
/**
* @param Collection<Participant> $participants
*
* @throws Exception
*
* @return array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}|array{}
*/
private function updateParticipantsCrmData(
Team $team,
Activity $activity,
Collection $participants,
?ServiceInterface $crmService = null,
): array {
$matchedRecords = [];
$matchedDomainRecords = [];
$this->validateCrmConfiguration($activity);
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
foreach ($participants as $participant) {
if ($this->shouldSkipParticipant($participant)) {
continue;
}
if (! $this->shouldPerformLookup($participant, $team)) {
$this->logger->info('[CrmActivityService] Email domain belongs to the team, skipping crm lookup', [
'activity_id' => $activity->getId(),
'team_id' => $team->getId(),
'email' => $participant->getEmailAddress(),
]);
$this->attachUserIfExists($participant, $team);
continue;
}
$records = $this->findCrmRecords($participant, $activity);
if (! empty($records)) {
$matchedRecords[] = $records;
} else {
$records = $this->findCrmDomainRecords(
crmService: $crmService,
participant: $participant,
activity: $activity,
);
if (! empty($records)) {
$matchedDomainRecords[] = $records;
}
}
if (empty($records)) {
continue;
}
try {
$activity->updateParticipantCrmData($records, $participant);
} catch (Throwable $ex) {
$this->logger->error('[CrmActivityService] Failed to update participant CRM data', [
'activity_id' => $activity->getId(),
'participant_id' => $participant->getId(),
'exception' => $ex->getMessage(),
]);
continue;
}
}
$bestMatch = $this->getBestMatch(
matchedRecords : $matchedRecords,
matchedDomainRecords: $matchedDomainRecords,
);
$this->logger->info('[CrmActivityService] CRM matching completed', [
'activity_id' => $activity->getId(),
'participants_processed' => $participants->count(),
'exact_matches' => count($matchedRecords),
'domain_matches' => count($matchedDomainRecords),
'best_match_found' => ! empty($bestMatch),
]);
return $bestMatch;
}
private function shouldPerformLookup(Participant $participant, Team $team): bool
{
if ($participant->hasEmailAddress()) {
return $this->emailHelper->shouldPerformLookup($team, $participant->getEmailAddress());
}
return true;
}
private function validateCrmConfiguration(Activity $activity): void
{
if ($activity->getCrm() === null) {
throw new InvalidArgumentException('Cannot find CRM configuration');
}
}
private function getBestMatch(?array $matchedRecords, ?array $matchedDomainRecords): array
{
return RecordSelector::pickBestFromLists($matchedRecords, $matchedDomainRecords);
}
private function findCrmRecords(Participant $participant, Activity $activity): ?array
{
$records = null;
if ($participant->hasEmailAddress()) {
$records = $this->decorator->matchExactlyByEmail(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
}
if (empty($records) && $participant->getPhoneNumber() !== null) {
$records = $this->decorator->matchByPhone(
phone: $participant->getPhoneNumber(),
userId: $activity->getUser()->getId(),
);
}
if (empty($records) && $participant->getName() !== null) {
$records = $this->decorator->matchByName(
name: $participant->getName(),
userId: $activity->getUser()->getId(),
);
}
return $records;
}
private function shouldSkipParticipant(Participant $participant): bool
{
return $participant->hasUser();
}
private function attachUserIfExists(Participant $participant, Team $team): void
{
if ($participant->hasEmailAddress() === false) {
return;
}
$user = $this->teamRepository->findActiveTeamMemberByEmail($team, $participant->getEmailAddress());
if ($user instanceof User) {
$participant->user_id = $user->getId();
$participant->save();
}
}
private function findCrmDomainRecords(
?ServiceInterface $crmService,
Participant $participant,
Activity $activity,
): array {
if ($participant->hasEmailAddress()) {
$this->decorator->setConfiguration($activity->getCrm());
$this->decorator->setCrmService($crmService);
$records = $this->decorator->matchByDomain(
email: $participant->getEmailAddress(),
userId: $activity->getUser()->getId()
);
if (! empty($records)) {
return $records;
}
}
return [];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CrmActivityService.php
|
NULL
|
9134
|
|
9133
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Code changed:
Hide
Sync Changes
Hide This Notification
7
48
1
33
1
Previous Highlighted Error
Next Highlighted Error
<?php
namespace Jiminny\Services\Crm\Hubspot;
use Carbon\Carbon;
use Exception;
use Generator;
use GuzzleHttp\Exception\RequestException;
use Illuminate\Support\Facades\Cache;
use InvalidArgumentException;
use Jiminny\Contracts\Repositories\TeamRepository;
use Jiminny\Contracts\Services\Crm\ClientInterface;
use Jiminny\Contracts\Services\Crm\FetchRelatedActivityInterface;
use Jiminny\Contracts\Services\Crm\LayoutManagementInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesInterface;
use Jiminny\Contracts\Services\Crm\Provider\HubspotInterface;
use Jiminny\Contracts\Services\Crm\RemoteEntityLookupInterface;
use Jiminny\Contracts\Services\Crm\RemoteEntityManipulationInterface;
use Jiminny\Contracts\Services\Crm\SavePlaybackLinkToCrmInterface;
use Jiminny\Contracts\Services\Crm\SendSummaryToCrmInterface;
use Jiminny\Contracts\Services\Crm\SettingsInterface;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Contracts\Services\Crm\SyncCrmMetadataInterface;
use Jiminny\Contracts\Services\Crm\VerifyTaskExistsInterface;
use Jiminny\Exceptions\CrmException;
use Jiminny\Exceptions\HttpNotFoundException;
use Jiminny\Jobs\Crm\NoteObject;
use Jiminny\Models\Account;
use Jiminny\Models\Activity;
use Jiminny\Models\Contact;
use Jiminny\Models\Contracts\ActivityContract;
use Jiminny\Models\Crm\BusinessProcess;
use Jiminny\Models\Crm\Field;
use Jiminny\Models\Crm\FieldData;
use Jiminny\Models\Crm\Layout;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Participant;
use Jiminny\Models\Playbook;
use Jiminny\Models\SocialAccount;
use Jiminny\Models\Stage;
use Jiminny\Models\User;
use Jiminny\Repositories\Crm\CrmEntityRepository;
use Jiminny\Repositories\Crm\FieldRepository;
use Jiminny\Repositories\Crm\ProfileRepository;
use Jiminny\Repositories\ParticipantRepository;
use Jiminny\Services\Avatar\ProspectPhotoPathService;
use Jiminny\Services\Crm\BaseService;
use Jiminny\Services\Crm\Hubspot\Actions\SyncArchivedProfilesAction;
use Jiminny\Services\Crm\Hubspot\Fields\ValueNormalizer;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\OpportunitySyncTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\SyncCrmEntitiesTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\SyncFieldsTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\WriteCrmTrait;
use Jiminny\Services\Crm\MatchDomainByEmailInterface;
use Jiminny\Services\Crm\OpportunitySyncStrategyResolver;
use Jiminny\Services\Crm\ResolveCompanyNameByEmailTrait;
use Jiminny\Utils\PlaybackUrlBuilder;
use Sentry;
use SevenShores\Hubspot\Exceptions\BadRequest;
use Throwable;
use UnexpectedValueException;
/**
* @phpstan-type CrmFieldDefinition array{
* name: string,
* label: string,
* description: string,
* type: string,
* fieldType: string,
* hidden: bool,
* showCurrencySymbol: bool,
* options: array<array{
* id: string,
* label: string,
* value?: string,
* }
*/
class Service extends BaseService implements
HubspotInterface,
SyncCrmEntitiesInterface,
SyncCrmMetadataInterface,
SendSummaryToCrmInterface,
MatchDomainByEmailInterface,
SavePlaybackLinkToCrmInterface,
RemoteEntityManipulationInterface,
FetchRelatedActivityInterface,
LayoutManagementInterface,
SettingsInterface,
MatchCrmEntitiesInterface,
RemoteEntityLookupInterface,
VerifyTaskExistsInterface
{
use ResolveCompanyNameByEmailTrait;
use SyncCrmEntitiesTrait;
use WriteCrmTrait;
use SyncFieldsTrait;
use OpportunitySyncTrait;
private const int ENGAGEMENT_BODY_MAX_LENGTH = 65536;
private const string LOG_DATE_FORMAT = 'Y-m-d H:i:s';
private const int BATCH_UPDATE_LIMIT = 100;
private const string TEN_SECONDLY_ROLLING_POLICY = 'TEN_SECONDLY_ROLLING';
private const int TEN_SECONDLY_ROLLING_LIMIT = 10;
private const string CALLS_SEARCH_ENDPOINT = '[URL_WITH_CREDENTIALS] ClientInterface|Client
*/
protected $client;
protected OpportunitySyncStrategyResolver $opportunitySyncStrategyResolver;
protected CrmEntityRepository $crmEntityRepository;
protected ProspectPhotoPathService $prospectPhotoPathService;
private SyncFieldAction $syncFieldAction;
private PayloadBuilder $payloadBuilder;
private SyncRelatedActivityManager $syncRelatedActivityManager;
private SyncArchivedProfilesAction $syncArchivedProfilesAction;
private WebhookSyncBatchProcessor $batchProcessor;
public function __construct(
Client $client,
SyncFieldAction $syncFieldAction,
PayloadBuilder $payloadBuilder,
ProspectPhotoPathService $prospectPhotoPathService,
SyncArchivedProfilesAction $syncArchivedProfilesAction,
WebhookSyncBatchProcessor $batchProcessor,
) {
parent::__construct();
$this->client = $client;
$this->syncFieldAction = $syncFieldAction;
$this->prospectPhotoPathService = $prospectPhotoPathService;
$this->payloadBuilder = $payloadBuilder;
$this->syncArchivedProfilesAction = $syncArchivedProfilesAction;
$this->batchProcessor = $batchProcessor;
$this->opportunitySyncStrategyResolver = app(OpportunitySyncStrategyResolver::class, [
'client' => $this->client,
]);
$this->syncRelatedActivityManager = app(SyncRelatedActivityManager::class, [
'client' => $this->client,
'payloadBuilder' => $this->payloadBuilder,
'logger' => $this->logger,
]);
$this->crmEntityRepository = app(CrmEntityRepository::class);
$this->dealFieldsService = app(DealFieldsService::class);
}
public function getDisplayName(): string
{
return 'HubSpot';
}
protected function getOAuthAccount(User $user): ?SocialAccount
{
// In this case, the Account Owner is always the connection for any API operations.
$owner = $user->team->owner;
return $owner->getSocialAccount(SocialAccount::PROVIDER_HUBSPOT);
}
public function getClient(): Client
{
/** @var Client */
return $this->client;
}
/**
* Convert raw field data into a format compatible with CRM APIs.
*
* @param bool $internal Direction of the conversion.
* True is pulling from CRM, false normalize before sending to CRM.
*/
public function normalizeValue(string $fieldType, string $fieldValue, bool $internal = false): string
{
return ValueNormalizer::normalize(
fieldType: $fieldType,
fieldValue: $fieldValue,
isInbound: $internal,
);
}
/**
* @inheritdoc
*/
public function getDefaultFields(string $activityType): array
{
$fields = [];
if ($activityType === Playbook::ACTIVITY_TYPE_TASK) {
$defaultFields = FieldDefinitions::defaultTaskFields();
// This lazy creates these fields if not already setup.
foreach ($defaultFields as $defaultField) {
$fields[] = $this->config->fields()->firstOrCreate($defaultField);
}
}
return $fields;
}
/**
* @inheritdoc
*/
public function getDefaultActivityField(string $activityType): Field
{
/** @var Field $activityField */
$activityField = $this->config->fields()->where([
'crm_provider_id' => 'activityType',
'object_type' => $activityType,
])->first();
return $activityField;
}
/**
* @inheritdoc
*/
public function getSupportedPlaybookTypes(): array
{
return [Playbook::ACTIVITY_TYPE_TASK];
}
/**
* @inheritdoc
*/
public function getDefaultActivityLayoutFields(string $activityType, string $layoutType): array
{
$fields = [];
if ($activityType === Playbook::ACTIVITY_TYPE_TASK) {
// Outcome should always be provided calls/meetings.
$fieldData = [
[
'crm_provider_id' => $layoutType === Layout::TYPE_SOFTPHONE_SUMMARY ? 'disposition' : 'meetingOutcome',
'object_type' => Field::OBJECT_TASK,
],
];
foreach ($fieldData as $data) {
$field = $this->config->fields()->where($data)->first();
// Only add the field if it is created, which it should be.
if ($field) {
$fields[] = $field;
}
}
}
return $fields;
}
public function getDealInsightsFields(): array
{
return FieldDefinitions::dealInsightsFields();
}
protected function getDefaultFollowupLayoutFields(string $activityType): array
{
$fields = [];
$fieldRepo = app(FieldRepository::class);
$fieldData = FieldDefinitions::followupFieldsFilter();
foreach ($fieldData as $data) {
$field = $fieldRepo->findOneConfigurationFieldByProperties($this->config, $data);
// Only add the field if it is created, which it should be.
if ($field) {
$fields[] = $field;
}
}
return $fields;
}
/**
* @inheritdoc
*/
public function syncField(Field $field): void
{
switch ($field->object_type) {
case Field::OBJECT_ACCOUNT:
$crmField = $this->client->getInstance()->companyProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_CONTACT:
$crmField = $this->client->getInstance()->contactProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_OPPORTUNITY:
$crmField = $this->client->getInstance()->dealProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_TASK:
$this->syncSingleTaskField($field);
return;
default:
return;
}
$this->syncFieldAction->execute($field, $crmField->toArray());
}
/**
* @param array<array{
* id:string,
* label:string,
* value?:string
* }> $options
*
* @throws CrmException
*
* @return FieldData[]
*
*/
public function importPicklistValues(
Field $field,
array $options = [['id' => '', 'label' => '', 'value' => '']],
): array {
if (! empty($options[0]['id']) || ! empty($options[0]['value'])) {
// We already have the options, no need to fetch them again
return $this->importOptions($field, $options);
}
$options = [];
switch ($field->getObjectType()) {
case Field::OBJECT_ACCOUNT:
$options = $this->getClient()->fetchPropertyOptions('company', $field->getCrmProviderId());
break;
case Field::OBJECT_CONTACT:
$options = $this->getClient()->fetchPropertyOptions('contact', $field->getCrmProviderId());
break;
case Field::OBJECT_OPPORTUNITY:
// Hubspot has different endpoint for stages
$options = $this->getClient()->fetchOpportunityFieldOptions($field);
break;
case Field::OBJECT_TASK:
if ($field->getCrmProviderId() === 'disposition') {
$options = $this->getClient()->fetchDispositionFieldOptions();
} elseif (in_array($field->getCrmProviderId(), ['meetingOutcome', 'activityType'])) {
$options = $this->getClient()->fetchMeetingOutcomeFieldOptions($field);
}
break;
default:
$this->logger->warning('Invalid object type', [
'object_type' => $field->getObjectType(),
'field_id' => $field->getId(),
]);
throw new CrmException('Invalid object type');
}
return $this->importOptions($field, $options);
}
/**
* @inheritdoc
*/
public function importStages(?array $types = null, ?string $missingStageName = null): ?Stage
{
$missingStage = null;
try {
// Use the HubSpot API client instead of the SDK crmPipelines() method
$endpoint = self::getDealsPipelinesEndpoint();
$pipelinesResponse = $this->client->getInstance()->getClient()->request('GET', $endpoint);
$pipelines = $pipelinesResponse->data->results;
} catch (RequestException|BadRequest $exception) {
throw $exception;
}
foreach ($pipelines as $pipeline) {
$stages = [];
// We create a business process to contain the pipeline, and store all stages against it.
$p = ResponseNormalize::normalizePipeline($pipeline);
// Create/update business process for this pipeline
$businessProcess = $this->config->businessProcesses()->updateOrCreate([
'crm_provider_id' => $p['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($p['label'], 0, 150),
'type' => BusinessProcess::TYPE_OPPORTUNITY,
'is_selectable' => $p['active'],
]);
// A record type is really a clone of the business process, used to store which record uses which pipeline.
// Create/update record type clone
$this->config->recordTypes()->updateOrCreate([
'crm_provider_id' => $p['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($p['label'], 0, 150),
'is_selectable' => $p['active'],
'business_process_id' => $businessProcess->id ?? null,
]);
// Stages - fetch all existing stages upfront to avoid N+1 queries
$existingStages = $this->config->stages()
->withTrashed()
->where('type', Stage::TYPE_OPPORTUNITY)
->get()
->keyBy('crm_provider_id');
foreach ($p['stages'] as $dealStage) {
$s = ResponseNormalize::normalizeDealStage($dealStage);
/** @var ?Stage $existingStage */
$existingStage = $existingStages->get($s['id']);
// Restore soft-deleted stages that are now active in HubSpot
if ($existingStage?->trashed() && $s['active']) {
$existingStage->restore();
}
// Upsert stage (updates soft-deleted records without restoring them)
$stage = $this->config->stages()->withTrashed()->updateOrCreate([
'crm_provider_id' => $s['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($s['label'], 0, 50),
'label' => mb_strimwidth($s['label'], 0, 191),
'type' => Stage::TYPE_OPPORTUNITY,
'sequence' => $s['displayOrder'],
'is_selectable' => $s['active'],
'probability' => $s['probability'] * 100,
]);
if ($missingStageName === $s['id']) {
$missingStage = $stage;
}
$stages[] = $stage->id;
}
$businessProcess->stages()->sync($stages);
}
return $missingStage;
}
/**
* @inheritdoc
*/
public function syncOrganization(): void
{
try {
$endpoint = '[URL_WITH_CREDENTIALS]
*/
public function find(string $name, array $scopes): array
{
$count = $this->limit ?? 20;
$offset = $this->offset ?? 0;
/** @var array<int, array<string, mixed>> */
return Cache::remember(
key: $this->team->getId() . $name . $count . $offset,
ttl: 300,
callback: function () use ($name, $offset, $count): array {
$data = [];
// Use the new V3 API to find contacts based on additional fields.
foreach (['companies', 'contacts'] as $objectType) {
$endpoint = '[URL_WITH_CREDENTIALS]
*/
public function findOpportunities(?string $crmAccountId, ?string $crmContactId, ?int $userId = null): array
{
$data = [];
$ownerData = [];
$ownerId = null;
if ($crmAccountId === null) {
return $data;
}
if ($userId) {
$profileRepository = app(ProfileRepository::class);
$profile = $profileRepository->findProfileByUserId($this->config, $userId);
$ownerId = $profile instanceof Profile ? $profile->getCrmProviderId() : null;
}
$closedStages = $this->getClosedDealStages();
$payload = $this->payloadBuilder->generateOpportunitiesSearchPayload(
$this->config,
$crmAccountId,
$closedStages,
);
$results = $this->client->getPaginatedData($payload, 'deals');
foreach ($results['results'] as $object) {
$properties = $object['properties'];
$amount = null;
if (empty($properties['amount']) === false) {
$currency = $properties['deal_currency_code'] ?? $this->config->default_currency;
// Values can contain commas and any junk so strip them.
$value = (float) preg_replace('/[^\d.]/', '', $properties['amount']);
$amount = formatCurrency($value, $currency);
}
$businessProcess = $this->config
->businessProcesses()
->where('crm_provider_id', $properties['pipeline'])
->first();
if ($businessProcess === null) {
// Import it.
$stage = $this->importStages([Stage::TYPE_OPPORTUNITY], $properties['dealstage']);
$businessProcess = $this->config
->businessProcesses()
->where('crm_provider_id', $properties['pipeline'])
->first();
} else {
$stage = $businessProcess
->stages()
->where('crm_provider_id', $properties['dealstage'])
->where('type', Stage::TYPE_OPPORTUNITY)
->first();
if ($stage === null) {
// Import it.
$stage = $this->importStages(null, $properties['dealstage']);
}
}
$recordType = null;
if ($businessProcess) {
$recordType = $businessProcess->recordTypes()->first();
}
$isWon = in_array($properties['dealstage'], $closedStages['won']);
$isLost = in_array($properties['dealstage'], $closedStages['lost']);
$record = [
'crmId' => $object['id'],
'name' => $properties['dealname'] ?? 'Unknown Deal',
'value' => $amount,
'won' => $isWon,
'closed' => $isWon || $isLost,
'stage' => [
'id' => $stage?->getUuid() ?? '',
'name' => $stage?->getName() ?? '',
],
];
if ($recordType) {
$record += [
'recordType' => [
'id' => $recordType->id_string,
'name' => $recordType->name,
],
];
}
if ($ownerId && isset($properties['hubspot_owner_id']) && $properties['hubspot_owner_id'] === $ownerId) {
$ownerData[] = $record;
}
$data[] = $record;
}
if (! empty($ownerData)) {
return $ownerData;
}
return $data;
}
/**
* @inheritdoc
*/
public function getTasks(?string $objectType, string $objectId, ?string $opportunityId): array
{
$data = [];
switch ($objectType) {
case 'contact':
$hsObject = 'contact';
break;
case 'account':
$hsObject = 'company';
break;
default:
// This is a hack to prioritise and override a contact/company with a deal.
if ($opportunityId) {
$hsObject = 'deal';
$objectId = $opportunityId;
} else {
throw new InvalidArgumentException('Object type not supported.');
}
}
$engagementTypes = ['meetings', 'tasks'];
foreach ($engagementTypes as $engagementType) {
$payload = $this->payloadBuilder->getLinkToTaskPayload($hsObject, $objectId, $engagementType);
$this->logger->info('[HubSpot] CRM Search requested', [
'request' => $payload,
]);
$engagements = $this->client->getPaginatedData($payload, $engagementType);
foreach ($engagements['results'] as $engagement) {
if ($engagementType == 'meetings') {
$title = $engagement['properties']['hs_meeting_title'] ?? 'Scheduled meeting';
} elseif ($engagementType == 'tasks') {
$title = $engagement['properties']['hs_task_subject'];
} else {
$title = 'Scheduled meeting';
}
$data[] = [
'crmId' => $engagement['id'],
'subject' => $title,
'due' => $engagement['properties']['hs_timestamp'],
'type' => $engagement['properties']['hs_activity_type'] ?? null,
];
}
}
usort($data, function ($item1, $item2) {
return $item2['due'] <=> $item1['due'];
});
return $data;
}
/**
* Try to find CRM Objects using email address
*
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
$contactProperties = [
'email',
'firstname',
'lastname',
'country',
'phone',
'mobilephone',
'jobtitle',
'hubspot_owner_id',
'associatedcompanyid',
'photo',
];
$contact = null;
$account = null;
try {
$hsContact = $this->getClient()->getContactByEmail($email, $contactProperties);
if ($hsContact) {
$contact = $this->importContact($hsContact);
$account = $contact->account;
}
$data = $this->convertCrmData($contact, $account, $userId);
return ! empty(array_filter($data)) ? $data : null;
} catch (BadRequest $e) {
$this->logger->warning('[HubSpot] Search failed', [
'team_id' => $this->team->getId(),
'search_identifier' => $email,
'reason' => $e->getMessage(),
]);
}
return null;
}
public function getDomain(string $email): ?string
{
return $this->getDomainFromEmail($email);
}
/**
* Try to find CRM objects using domain name of the email address
*
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByDomain(string $domain, ?int $userId = null): ?array
{
$companyName = $domain;
// Try to find a company matching their email domain.
$companyProperties = [
'country',
'phone',
'name',
'hs_avatar_filemanager_key',
'industry',
'hubspot_owner_id',
'domain',
];
try {
$hsAccounts = $this->client
->getInstance()
->companies()
->searchByDomain($companyName, $companyProperties);
} catch (Throwable $e) {
$this->logger->info('[HubSpot] Search failed', [
'error' => $e->getMessage(),
'domain' => $domain,
]);
return null;
}
$account = null;
// If there are multiple accounts, don't guess, we'll ask later.
if (\count($hsAccounts->data->results) === 1) {
// Persist this remote object.
$account = $this->syncAccount($hsAccounts->data->results[0]->companyId);
}
$data = $this->convertCrmData(null, $account, $userId);
return ! empty(array_filter($data)) ? $data : null;
}
/**
* @return array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
protected function convertCrmData(?Contact $contact, ?Account $account, ?int $userId = null): array
{
$countryCode = null;
if ($contact && $contact->country_code) {
$countryCode = $contact->country_code;
} elseif ($account && $account->country_code) {
$countryCode = $account->country_code;
}
try {
$hsOpportunities = $this->findOpportunities(
$account ? $account->crm_provider_id : null,
$contact ? $contact->crm_provider_id : null,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
// If there are multiple opportunities, don't guess, we'll ask later.
$opportunity = null;
$stage = null;
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
}
protected function getCacheKey(string $object, ?int $userId = null): ?string
{
$key = $this->team->getId() . $object;
$keySuffix = $this->getOwnerKeySuffix($userId);
return $key . $keySuffix;
}
private function getOwnerKeySuffix(?int $userId = null): string
{
return $userId === null ? '' : (string) $userId;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
if (str_contains($phone, '**')) {
return null;
}
// trim all whitespaces if present so the lookup doesn't fail
$phone = str_replace(' ', '', $phone);
// Check if the user is internal.
if ($this->isPhoneNumberOfTeamMember($phone)) {
return null;
}
$response = $this->searchForPhoneNumber($phone);
if (empty($response)) {
return null;
}
// This would ideally importContact instead but the response type differs.
$contact = $this->findAndSyncContact($response['results'][0]['id']);
if (! $contact instanceof Contact) {
return null;
}
$account = $contact->account;
$countryCode = $contact->country_code ?? $account->country_code ?? null;
try {
$hsOpportunities = $this->findOpportunities(
$account?->crm_provider_id,
$contact->crm_provider_id,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
$opportunity = null;
$stage = null;
try {
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
} catch (Exception $e) {
$this->logger->debug('[HubSpot] Opportunity failed to sync.', [
'reason' => $e->getMessage(),
]);
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
}
private function isPhoneNumberOfTeamMember(string $phone): bool
{
$teamRepository = app(TeamRepository::class);
$user = $teamRepository->findTeamMemberByPhone($this->team, $phone);
if ($user instanceof User) {
return true;
}
return false;
}
private function findAndSyncContact(string $crmId): ?Contact
{
try {
return $this->syncContact($crmId);
} catch (Exception $exception) {
$this->logger->info('[HubSpot] Phone match failed', [
'reason' => $exception->getMessage(),
]);
return null;
}
}
private function hasResults(array $response): bool
{
return isset($response['total']) && is_numeric($response['total']) && $response['total'] > 0;
}
private function searchForPhoneNumber(string $phone): array
{
// Normalizes the provided phone number for the API search.
$normalizedPhone = $this->normalizePhoneNumber($phone);
$payload = $this->payloadBuilder->generatePhoneSearchPayload($normalizedPhone);
$this->logger->info('[HubSpot] Phone match search triggered', [
'phone' => $phone,
'normalizedPhone' => $normalizedPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($normalizedPhone, $payload);
if (! $this->hasResults($response)) {
$nationalPhone = preg_replace('/\D/', '', phone_national(null, $phone));
$payload = $this->payloadBuilder->generatePhoneSearchPayload($nationalPhone);
$this->logger->info('[HubSpot] Phone match national number search triggered', [
'phone' => $phone,
'nationalPhone' => $nationalPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($phone, $payload);
}
if (! $this->hasResults($response)) {
$payload = $this->payloadBuilder->generatePhoneSearchPayload($normalizedPhone, true);
$this->logger->info('[HubSpot] Phone match alternative search triggered', [
'phone' => $phone,
'normalizedPhone' => $normalizedPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($phone, $payload);
}
return $this->hasResults($response) ? $response : [];
}
private function handlePhoneSearchRequest(string $phone, array $payload): array
{
$endpoint = '[URL_WITH_CREDENTIALS] null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
// Don't waste time searching for single character strings.
if (\strlen($name) <= 1) {
return null;
}
$cacheKey = $this->getCacheKey($name, $userId);
$result = Cache::remember($cacheKey, 60, function () use ($name, $userId) {
$payload = $this->payloadBuilder->generateSearchContactsByNamePayload(
$name,
$this->getContactFields()
);
$hsContacts = $this->client->getPaginatedData($payload, 'contact');
if (empty($hsContacts['results'])) {
return false;
}
$contact = $this->importContact($hsContacts['results'][0]);
if ($contact === null) {
return false;
}
$account = $contact->account;
$countryCode = $contact->country_code ?? $account->country_code ?? null;
try {
$hsOpportunities = $this->findOpportunities(
$account ? $account->crm_provider_id : null,
$contact->crm_provider_id,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
$opportunity = null;
$stage = null;
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
});
return is_array($result) ? $result : null;
}
private function convertActivityAssociations(Activity $activity): array
{
return [
'contactIds' => $this->getParticipantsIds($activity),
'companyIds' => $activity->hasAccount() ? [$activity->account->crm_provider_id] : [],
'dealIds' => $activity->hasOpportunity() ? [$activity->opportunity->crm_provider_id] : [],
'ownerIds' => [],
];
}
private function getParticipantsIds(Activity $activity): array
{
$attendees = [];
$participantRepository = app(ParticipantRepository::class);
$participants = $participantRepository->getParticipantsWhoEnteredMeeting($activity);
foreach ($participants as $participant) {
if ($participant->user_id || $participant->isCoach()) {
continue;
}
$contact = $participant->contact()->first();
if ($contact && $contact->crm_provider_id) {
$attendees[] = $contact->crm_provider_id;
} else {
if (! empty($participant->name)) {
$attendeeData = $this->fetchMissingAttendeeInfo($participant);
}
if (! empty($attendeeData['id'])) {
$attendees[] = $attendeeData['id'];
}
}
}
if ($activity->hasContact()) {
$attendees[] = $activity->contact->crm_provider_id;
}
return array_unique($attendees);
}
private function fetchMissingAttendeeInfo(Participant $participant): array
{
// Check if we need to look inside an account context.
$activity = $participant->getActivity();
$companyId = $activity->hasAccount() ? $activity->getAccount()->crm_provider_id : null;
// First check the local data.
/** @var Contact[] $contacts */
$contacts = $this->team->contacts()
->with('account')
->where('name', $participant->name)
->whereNotNull('email')
->get();
foreach ($contacts as $contact) {
// If we have a company in scope, check the contact is associated to it.
if (
$companyId !== null
&& ($contact->account_id === null || $companyId !== $contact->account->crm_provider_id)
) {
continue;
}
return [
'id' => $contact->crm_provider_id,
'email' => $contact->email,
];
}
$payload = $this->generateNameSearchPayload($participant->name, 0, 20);
try {
$response = $this->client->getNewInstance()->crm()->contacts()->searchApi()->doSearch($payload);
// TODO add some logic to choose the most suitable contact if multiple
foreach ($response['results'] as $object) {
$properties = $object['properties'];
if (empty($object['properties']) === false) {
// Check the company matches the contact.
// Todo: Move this check inside the API search.
if ($companyId !== null && $companyId !== $properties['associatedcompanyid']) {
continue;
}
return [
'id' => $object['id'],
'email' => $properties['email'],
];
}
}
} catch (Exception $e) {
$this->logger->warning('[' . $this->getDisplayName() . '] Search failed', [
'teamId' => $this->team->id_string,
'request' => $payload,
'reason' => $e->getMessage(),
]);
}
return [];
}
/**
* Store transcripts as note engagement.
*
* @throws Exception
*/
public function createTranscriptNotes(Activity $activity): void
{
// For HS no need to check if Crm profile - Log Notes field is enabled
// We only check if store_transcript toggle is enabled on crm profile.
$engagement = [
'active' => true,
'ownerId' => $this->profile->crm_provider_id,
'timestamp' => $activity->created_at->tz($activity->user->timezone)->getTimestamp() * 1000,
'type' => 'NOTE',
];
// Generate activity transcription.
$transcriptionData = $this->generateTranscription($activity);
// Truncate Notes with max notes length because transcription text could be very long.
$transcripts = mb_strimwidth($transcriptionData, 0, static::ENGAGEMENT_BODY_MAX_LENGTH);
$metadata = [
'body' => $transcripts,
];
$associations = $this->convertActivityAssociations($activity);
try {
$hsEngagement = $this->client
->getInstance()
->engagements()
->create($engagement, $associations, $metadata);
$this->logCrmEngagementManipulation(self::ACTION_CREATE, $engagement, $metadata, $associations);
$noteId = $hsEngagement->data->engagement->id;
// Store crm logged id in transcription.
$transcription = $activity->getTranscription();
$transcription->crm_activity_id = $noteId;
$transcription->save();
} catch (Exception $e) {
Sentry::captureException($e);
}
}
/*
* @inheritdoc
*/
public function updateRecord(string $objectType, string $objectId, array $data, array $headers = []): void
{
$payload = [
'properties' => $data,
];
try {
switch ($objectType) {
case FieldData::OBJECT_OPPORTUNITY:
$this->client->getNewInstance()->crm()->deals()->basicApi()->update($objectId, $payload);
break;
case FieldData::OBJECT_CONTACT:
$this->client->getNewInstance()->crm()->contacts()->basicApi()->update($objectId, $payload);
break;
case Fi...
|
PhpStorm
|
faVsco.js – Service.php
|
NULL
|
9133
|
|
9132
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Code changed:
Hide
Sync Changes
Hide This Notification
7
48
1
33
1
Previous Highlighted Error
Next Highlighted Error
<?php
namespace Jiminny\Services\Crm\Hubspot;
use Carbon\Carbon;
use Exception;
use Generator;
use GuzzleHttp\Exception\RequestException;
use Illuminate\Support\Facades\Cache;
use InvalidArgumentException;
use Jiminny\Contracts\Repositories\TeamRepository;
use Jiminny\Contracts\Services\Crm\ClientInterface;
use Jiminny\Contracts\Services\Crm\FetchRelatedActivityInterface;
use Jiminny\Contracts\Services\Crm\LayoutManagementInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesInterface;
use Jiminny\Contracts\Services\Crm\Provider\HubspotInterface;
use Jiminny\Contracts\Services\Crm\RemoteEntityLookupInterface;
use Jiminny\Contracts\Services\Crm\RemoteEntityManipulationInterface;
use Jiminny\Contracts\Services\Crm\SavePlaybackLinkToCrmInterface;
use Jiminny\Contracts\Services\Crm\SendSummaryToCrmInterface;
use Jiminny\Contracts\Services\Crm\SettingsInterface;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Contracts\Services\Crm\SyncCrmMetadataInterface;
use Jiminny\Contracts\Services\Crm\VerifyTaskExistsInterface;
use Jiminny\Exceptions\CrmException;
use Jiminny\Exceptions\HttpNotFoundException;
use Jiminny\Jobs\Crm\NoteObject;
use Jiminny\Models\Account;
use Jiminny\Models\Activity;
use Jiminny\Models\Contact;
use Jiminny\Models\Contracts\ActivityContract;
use Jiminny\Models\Crm\BusinessProcess;
use Jiminny\Models\Crm\Field;
use Jiminny\Models\Crm\FieldData;
use Jiminny\Models\Crm\Layout;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Participant;
use Jiminny\Models\Playbook;
use Jiminny\Models\SocialAccount;
use Jiminny\Models\Stage;
use Jiminny\Models\User;
use Jiminny\Repositories\Crm\CrmEntityRepository;
use Jiminny\Repositories\Crm\FieldRepository;
use Jiminny\Repositories\Crm\ProfileRepository;
use Jiminny\Repositories\ParticipantRepository;
use Jiminny\Services\Avatar\ProspectPhotoPathService;
use Jiminny\Services\Crm\BaseService;
use Jiminny\Services\Crm\Hubspot\Actions\SyncArchivedProfilesAction;
use Jiminny\Services\Crm\Hubspot\Fields\ValueNormalizer;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\OpportunitySyncTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\SyncCrmEntitiesTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\SyncFieldsTrait;
use Jiminny\Services\Crm\Hubspot\ServiceTraits\WriteCrmTrait;
use Jiminny\Services\Crm\MatchDomainByEmailInterface;
use Jiminny\Services\Crm\OpportunitySyncStrategyResolver;
use Jiminny\Services\Crm\ResolveCompanyNameByEmailTrait;
use Jiminny\Utils\PlaybackUrlBuilder;
use Sentry;
use SevenShores\Hubspot\Exceptions\BadRequest;
use Throwable;
use UnexpectedValueException;
/**
* @phpstan-type CrmFieldDefinition array{
* name: string,
* label: string,
* description: string,
* type: string,
* fieldType: string,
* hidden: bool,
* showCurrencySymbol: bool,
* options: array<array{
* id: string,
* label: string,
* value?: string,
* }
*/
class Service extends BaseService implements
HubspotInterface,
SyncCrmEntitiesInterface,
SyncCrmMetadataInterface,
SendSummaryToCrmInterface,
MatchDomainByEmailInterface,
SavePlaybackLinkToCrmInterface,
RemoteEntityManipulationInterface,
FetchRelatedActivityInterface,
LayoutManagementInterface,
SettingsInterface,
MatchCrmEntitiesInterface,
RemoteEntityLookupInterface,
VerifyTaskExistsInterface
{
use ResolveCompanyNameByEmailTrait;
use SyncCrmEntitiesTrait;
use WriteCrmTrait;
use SyncFieldsTrait;
use OpportunitySyncTrait;
private const int ENGAGEMENT_BODY_MAX_LENGTH = 65536;
private const string LOG_DATE_FORMAT = 'Y-m-d H:i:s';
private const int BATCH_UPDATE_LIMIT = 100;
private const string TEN_SECONDLY_ROLLING_POLICY = 'TEN_SECONDLY_ROLLING';
private const int TEN_SECONDLY_ROLLING_LIMIT = 10;
private const string CALLS_SEARCH_ENDPOINT = '[URL_WITH_CREDENTIALS] ClientInterface|Client
*/
protected $client;
protected OpportunitySyncStrategyResolver $opportunitySyncStrategyResolver;
protected CrmEntityRepository $crmEntityRepository;
protected ProspectPhotoPathService $prospectPhotoPathService;
private SyncFieldAction $syncFieldAction;
private PayloadBuilder $payloadBuilder;
private SyncRelatedActivityManager $syncRelatedActivityManager;
private SyncArchivedProfilesAction $syncArchivedProfilesAction;
private WebhookSyncBatchProcessor $batchProcessor;
public function __construct(
Client $client,
SyncFieldAction $syncFieldAction,
PayloadBuilder $payloadBuilder,
ProspectPhotoPathService $prospectPhotoPathService,
SyncArchivedProfilesAction $syncArchivedProfilesAction,
WebhookSyncBatchProcessor $batchProcessor,
) {
parent::__construct();
$this->client = $client;
$this->syncFieldAction = $syncFieldAction;
$this->prospectPhotoPathService = $prospectPhotoPathService;
$this->payloadBuilder = $payloadBuilder;
$this->syncArchivedProfilesAction = $syncArchivedProfilesAction;
$this->batchProcessor = $batchProcessor;
$this->opportunitySyncStrategyResolver = app(OpportunitySyncStrategyResolver::class, [
'client' => $this->client,
]);
$this->syncRelatedActivityManager = app(SyncRelatedActivityManager::class, [
'client' => $this->client,
'payloadBuilder' => $this->payloadBuilder,
'logger' => $this->logger,
]);
$this->crmEntityRepository = app(CrmEntityRepository::class);
$this->dealFieldsService = app(DealFieldsService::class);
}
public function getDisplayName(): string
{
return 'HubSpot';
}
protected function getOAuthAccount(User $user): ?SocialAccount
{
// In this case, the Account Owner is always the connection for any API operations.
$owner = $user->team->owner;
return $owner->getSocialAccount(SocialAccount::PROVIDER_HUBSPOT);
}
public function getClient(): Client
{
/** @var Client */
return $this->client;
}
/**
* Convert raw field data into a format compatible with CRM APIs.
*
* @param bool $internal Direction of the conversion.
* True is pulling from CRM, false normalize before sending to CRM.
*/
public function normalizeValue(string $fieldType, string $fieldValue, bool $internal = false): string
{
return ValueNormalizer::normalize(
fieldType: $fieldType,
fieldValue: $fieldValue,
isInbound: $internal,
);
}
/**
* @inheritdoc
*/
public function getDefaultFields(string $activityType): array
{
$fields = [];
if ($activityType === Playbook::ACTIVITY_TYPE_TASK) {
$defaultFields = FieldDefinitions::defaultTaskFields();
// This lazy creates these fields if not already setup.
foreach ($defaultFields as $defaultField) {
$fields[] = $this->config->fields()->firstOrCreate($defaultField);
}
}
return $fields;
}
/**
* @inheritdoc
*/
public function getDefaultActivityField(string $activityType): Field
{
/** @var Field $activityField */
$activityField = $this->config->fields()->where([
'crm_provider_id' => 'activityType',
'object_type' => $activityType,
])->first();
return $activityField;
}
/**
* @inheritdoc
*/
public function getSupportedPlaybookTypes(): array
{
return [Playbook::ACTIVITY_TYPE_TASK];
}
/**
* @inheritdoc
*/
public function getDefaultActivityLayoutFields(string $activityType, string $layoutType): array
{
$fields = [];
if ($activityType === Playbook::ACTIVITY_TYPE_TASK) {
// Outcome should always be provided calls/meetings.
$fieldData = [
[
'crm_provider_id' => $layoutType === Layout::TYPE_SOFTPHONE_SUMMARY ? 'disposition' : 'meetingOutcome',
'object_type' => Field::OBJECT_TASK,
],
];
foreach ($fieldData as $data) {
$field = $this->config->fields()->where($data)->first();
// Only add the field if it is created, which it should be.
if ($field) {
$fields[] = $field;
}
}
}
return $fields;
}
public function getDealInsightsFields(): array
{
return FieldDefinitions::dealInsightsFields();
}
protected function getDefaultFollowupLayoutFields(string $activityType): array
{
$fields = [];
$fieldRepo = app(FieldRepository::class);
$fieldData = FieldDefinitions::followupFieldsFilter();
foreach ($fieldData as $data) {
$field = $fieldRepo->findOneConfigurationFieldByProperties($this->config, $data);
// Only add the field if it is created, which it should be.
if ($field) {
$fields[] = $field;
}
}
return $fields;
}
/**
* @inheritdoc
*/
public function syncField(Field $field): void
{
switch ($field->object_type) {
case Field::OBJECT_ACCOUNT:
$crmField = $this->client->getInstance()->companyProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_CONTACT:
$crmField = $this->client->getInstance()->contactProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_OPPORTUNITY:
$crmField = $this->client->getInstance()->dealProperties()->get($field->crm_provider_id);
break;
case Field::OBJECT_TASK:
$this->syncSingleTaskField($field);
return;
default:
return;
}
$this->syncFieldAction->execute($field, $crmField->toArray());
}
/**
* @param array<array{
* id:string,
* label:string,
* value?:string
* }> $options
*
* @throws CrmException
*
* @return FieldData[]
*
*/
public function importPicklistValues(
Field $field,
array $options = [['id' => '', 'label' => '', 'value' => '']],
): array {
if (! empty($options[0]['id']) || ! empty($options[0]['value'])) {
// We already have the options, no need to fetch them again
return $this->importOptions($field, $options);
}
$options = [];
switch ($field->getObjectType()) {
case Field::OBJECT_ACCOUNT:
$options = $this->getClient()->fetchPropertyOptions('company', $field->getCrmProviderId());
break;
case Field::OBJECT_CONTACT:
$options = $this->getClient()->fetchPropertyOptions('contact', $field->getCrmProviderId());
break;
case Field::OBJECT_OPPORTUNITY:
// Hubspot has different endpoint for stages
$options = $this->getClient()->fetchOpportunityFieldOptions($field);
break;
case Field::OBJECT_TASK:
if ($field->getCrmProviderId() === 'disposition') {
$options = $this->getClient()->fetchDispositionFieldOptions();
} elseif (in_array($field->getCrmProviderId(), ['meetingOutcome', 'activityType'])) {
$options = $this->getClient()->fetchMeetingOutcomeFieldOptions($field);
}
break;
default:
$this->logger->warning('Invalid object type', [
'object_type' => $field->getObjectType(),
'field_id' => $field->getId(),
]);
throw new CrmException('Invalid object type');
}
return $this->importOptions($field, $options);
}
/**
* @inheritdoc
*/
public function importStages(?array $types = null, ?string $missingStageName = null): ?Stage
{
$missingStage = null;
try {
// Use the HubSpot API client instead of the SDK crmPipelines() method
$endpoint = self::getDealsPipelinesEndpoint();
$pipelinesResponse = $this->client->getInstance()->getClient()->request('GET', $endpoint);
$pipelines = $pipelinesResponse->data->results;
} catch (RequestException|BadRequest $exception) {
throw $exception;
}
foreach ($pipelines as $pipeline) {
$stages = [];
// We create a business process to contain the pipeline, and store all stages against it.
$p = ResponseNormalize::normalizePipeline($pipeline);
// Create/update business process for this pipeline
$businessProcess = $this->config->businessProcesses()->updateOrCreate([
'crm_provider_id' => $p['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($p['label'], 0, 150),
'type' => BusinessProcess::TYPE_OPPORTUNITY,
'is_selectable' => $p['active'],
]);
// A record type is really a clone of the business process, used to store which record uses which pipeline.
// Create/update record type clone
$this->config->recordTypes()->updateOrCreate([
'crm_provider_id' => $p['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($p['label'], 0, 150),
'is_selectable' => $p['active'],
'business_process_id' => $businessProcess->id ?? null,
]);
// Stages - fetch all existing stages upfront to avoid N+1 queries
$existingStages = $this->config->stages()
->withTrashed()
->where('type', Stage::TYPE_OPPORTUNITY)
->get()
->keyBy('crm_provider_id');
foreach ($p['stages'] as $dealStage) {
$s = ResponseNormalize::normalizeDealStage($dealStage);
/** @var ?Stage $existingStage */
$existingStage = $existingStages->get($s['id']);
// Restore soft-deleted stages that are now active in HubSpot
if ($existingStage?->trashed() && $s['active']) {
$existingStage->restore();
}
// Upsert stage (updates soft-deleted records without restoring them)
$stage = $this->config->stages()->withTrashed()->updateOrCreate([
'crm_provider_id' => $s['id'],
], [
'team_id' => $this->team->id,
'name' => mb_strimwidth($s['label'], 0, 50),
'label' => mb_strimwidth($s['label'], 0, 191),
'type' => Stage::TYPE_OPPORTUNITY,
'sequence' => $s['displayOrder'],
'is_selectable' => $s['active'],
'probability' => $s['probability'] * 100,
]);
if ($missingStageName === $s['id']) {
$missingStage = $stage;
}
$stages[] = $stage->id;
}
$businessProcess->stages()->sync($stages);
}
return $missingStage;
}
/**
* @inheritdoc
*/
public function syncOrganization(): void
{
try {
$endpoint = '[URL_WITH_CREDENTIALS]
*/
public function find(string $name, array $scopes): array
{
$count = $this->limit ?? 20;
$offset = $this->offset ?? 0;
/** @var array<int, array<string, mixed>> */
return Cache::remember(
key: $this->team->getId() . $name . $count . $offset,
ttl: 300,
callback: function () use ($name, $offset, $count): array {
$data = [];
// Use the new V3 API to find contacts based on additional fields.
foreach (['companies', 'contacts'] as $objectType) {
$endpoint = '[URL_WITH_CREDENTIALS]
*/
public function findOpportunities(?string $crmAccountId, ?string $crmContactId, ?int $userId = null): array
{
$data = [];
$ownerData = [];
$ownerId = null;
if ($crmAccountId === null) {
return $data;
}
if ($userId) {
$profileRepository = app(ProfileRepository::class);
$profile = $profileRepository->findProfileByUserId($this->config, $userId);
$ownerId = $profile instanceof Profile ? $profile->getCrmProviderId() : null;
}
$closedStages = $this->getClosedDealStages();
$payload = $this->payloadBuilder->generateOpportunitiesSearchPayload(
$this->config,
$crmAccountId,
$closedStages,
);
$results = $this->client->getPaginatedData($payload, 'deals');
foreach ($results['results'] as $object) {
$properties = $object['properties'];
$amount = null;
if (empty($properties['amount']) === false) {
$currency = $properties['deal_currency_code'] ?? $this->config->default_currency;
// Values can contain commas and any junk so strip them.
$value = (float) preg_replace('/[^\d.]/', '', $properties['amount']);
$amount = formatCurrency($value, $currency);
}
$businessProcess = $this->config
->businessProcesses()
->where('crm_provider_id', $properties['pipeline'])
->first();
if ($businessProcess === null) {
// Import it.
$stage = $this->importStages([Stage::TYPE_OPPORTUNITY], $properties['dealstage']);
$businessProcess = $this->config
->businessProcesses()
->where('crm_provider_id', $properties['pipeline'])
->first();
} else {
$stage = $businessProcess
->stages()
->where('crm_provider_id', $properties['dealstage'])
->where('type', Stage::TYPE_OPPORTUNITY)
->first();
if ($stage === null) {
// Import it.
$stage = $this->importStages(null, $properties['dealstage']);
}
}
$recordType = null;
if ($businessProcess) {
$recordType = $businessProcess->recordTypes()->first();
}
$isWon = in_array($properties['dealstage'], $closedStages['won']);
$isLost = in_array($properties['dealstage'], $closedStages['lost']);
$record = [
'crmId' => $object['id'],
'name' => $properties['dealname'] ?? 'Unknown Deal',
'value' => $amount,
'won' => $isWon,
'closed' => $isWon || $isLost,
'stage' => [
'id' => $stage?->getUuid() ?? '',
'name' => $stage?->getName() ?? '',
],
];
if ($recordType) {
$record += [
'recordType' => [
'id' => $recordType->id_string,
'name' => $recordType->name,
],
];
}
if ($ownerId && isset($properties['hubspot_owner_id']) && $properties['hubspot_owner_id'] === $ownerId) {
$ownerData[] = $record;
}
$data[] = $record;
}
if (! empty($ownerData)) {
return $ownerData;
}
return $data;
}
/**
* @inheritdoc
*/
public function getTasks(?string $objectType, string $objectId, ?string $opportunityId): array
{
$data = [];
switch ($objectType) {
case 'contact':
$hsObject = 'contact';
break;
case 'account':
$hsObject = 'company';
break;
default:
// This is a hack to prioritise and override a contact/company with a deal.
if ($opportunityId) {
$hsObject = 'deal';
$objectId = $opportunityId;
} else {
throw new InvalidArgumentException('Object type not supported.');
}
}
$engagementTypes = ['meetings', 'tasks'];
foreach ($engagementTypes as $engagementType) {
$payload = $this->payloadBuilder->getLinkToTaskPayload($hsObject, $objectId, $engagementType);
$this->logger->info('[HubSpot] CRM Search requested', [
'request' => $payload,
]);
$engagements = $this->client->getPaginatedData($payload, $engagementType);
foreach ($engagements['results'] as $engagement) {
if ($engagementType == 'meetings') {
$title = $engagement['properties']['hs_meeting_title'] ?? 'Scheduled meeting';
} elseif ($engagementType == 'tasks') {
$title = $engagement['properties']['hs_task_subject'];
} else {
$title = 'Scheduled meeting';
}
$data[] = [
'crmId' => $engagement['id'],
'subject' => $title,
'due' => $engagement['properties']['hs_timestamp'],
'type' => $engagement['properties']['hs_activity_type'] ?? null,
];
}
}
usort($data, function ($item1, $item2) {
return $item2['due'] <=> $item1['due'];
});
return $data;
}
/**
* Try to find CRM Objects using email address
*
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
$contactProperties = [
'email',
'firstname',
'lastname',
'country',
'phone',
'mobilephone',
'jobtitle',
'hubspot_owner_id',
'associatedcompanyid',
'photo',
];
$contact = null;
$account = null;
try {
$hsContact = $this->getClient()->getContactByEmail($email, $contactProperties);
if ($hsContact) {
$contact = $this->importContact($hsContact);
$account = $contact->account;
}
$data = $this->convertCrmData($contact, $account, $userId);
return ! empty(array_filter($data)) ? $data : null;
} catch (BadRequest $e) {
$this->logger->warning('[HubSpot] Search failed', [
'team_id' => $this->team->getId(),
'search_identifier' => $email,
'reason' => $e->getMessage(),
]);
}
return null;
}
public function getDomain(string $email): ?string
{
return $this->getDomainFromEmail($email);
}
/**
* Try to find CRM objects using domain name of the email address
*
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByDomain(string $domain, ?int $userId = null): ?array
{
$companyName = $domain;
// Try to find a company matching their email domain.
$companyProperties = [
'country',
'phone',
'name',
'hs_avatar_filemanager_key',
'industry',
'hubspot_owner_id',
'domain',
];
try {
$hsAccounts = $this->client
->getInstance()
->companies()
->searchByDomain($companyName, $companyProperties);
} catch (Throwable $e) {
$this->logger->info('[HubSpot] Search failed', [
'error' => $e->getMessage(),
'domain' => $domain,
]);
return null;
}
$account = null;
// If there are multiple accounts, don't guess, we'll ask later.
if (\count($hsAccounts->data->results) === 1) {
// Persist this remote object.
$account = $this->syncAccount($hsAccounts->data->results[0]->companyId);
}
$data = $this->convertCrmData(null, $account, $userId);
return ! empty(array_filter($data)) ? $data : null;
}
/**
* @return array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
protected function convertCrmData(?Contact $contact, ?Account $account, ?int $userId = null): array
{
$countryCode = null;
if ($contact && $contact->country_code) {
$countryCode = $contact->country_code;
} elseif ($account && $account->country_code) {
$countryCode = $account->country_code;
}
try {
$hsOpportunities = $this->findOpportunities(
$account ? $account->crm_provider_id : null,
$contact ? $contact->crm_provider_id : null,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
// If there are multiple opportunities, don't guess, we'll ask later.
$opportunity = null;
$stage = null;
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
}
protected function getCacheKey(string $object, ?int $userId = null): ?string
{
$key = $this->team->getId() . $object;
$keySuffix = $this->getOwnerKeySuffix($userId);
return $key . $keySuffix;
}
private function getOwnerKeySuffix(?int $userId = null): string
{
return $userId === null ? '' : (string) $userId;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
if (str_contains($phone, '**')) {
return null;
}
// trim all whitespaces if present so the lookup doesn't fail
$phone = str_replace(' ', '', $phone);
// Check if the user is internal.
if ($this->isPhoneNumberOfTeamMember($phone)) {
return null;
}
$response = $this->searchForPhoneNumber($phone);
if (empty($response)) {
return null;
}
// This would ideally importContact instead but the response type differs.
$contact = $this->findAndSyncContact($response['results'][0]['id']);
if (! $contact instanceof Contact) {
return null;
}
$account = $contact->account;
$countryCode = $contact->country_code ?? $account->country_code ?? null;
try {
$hsOpportunities = $this->findOpportunities(
$account?->crm_provider_id,
$contact->crm_provider_id,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
$opportunity = null;
$stage = null;
try {
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
} catch (Exception $e) {
$this->logger->debug('[HubSpot] Opportunity failed to sync.', [
'reason' => $e->getMessage(),
]);
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
}
private function isPhoneNumberOfTeamMember(string $phone): bool
{
$teamRepository = app(TeamRepository::class);
$user = $teamRepository->findTeamMemberByPhone($this->team, $phone);
if ($user instanceof User) {
return true;
}
return false;
}
private function findAndSyncContact(string $crmId): ?Contact
{
try {
return $this->syncContact($crmId);
} catch (Exception $exception) {
$this->logger->info('[HubSpot] Phone match failed', [
'reason' => $exception->getMessage(),
]);
return null;
}
}
private function hasResults(array $response): bool
{
return isset($response['total']) && is_numeric($response['total']) && $response['total'] > 0;
}
private function searchForPhoneNumber(string $phone): array
{
// Normalizes the provided phone number for the API search.
$normalizedPhone = $this->normalizePhoneNumber($phone);
$payload = $this->payloadBuilder->generatePhoneSearchPayload($normalizedPhone);
$this->logger->info('[HubSpot] Phone match search triggered', [
'phone' => $phone,
'normalizedPhone' => $normalizedPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($normalizedPhone, $payload);
if (! $this->hasResults($response)) {
$nationalPhone = preg_replace('/\D/', '', phone_national(null, $phone));
$payload = $this->payloadBuilder->generatePhoneSearchPayload($nationalPhone);
$this->logger->info('[HubSpot] Phone match national number search triggered', [
'phone' => $phone,
'nationalPhone' => $nationalPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($phone, $payload);
}
if (! $this->hasResults($response)) {
$payload = $this->payloadBuilder->generatePhoneSearchPayload($normalizedPhone, true);
$this->logger->info('[HubSpot] Phone match alternative search triggered', [
'phone' => $phone,
'normalizedPhone' => $normalizedPhone,
'payload' => $payload,
]);
$response = $this->handlePhoneSearchRequest($phone, $payload);
}
return $this->hasResults($response) ? $response : [];
}
private function handlePhoneSearchRequest(string $phone, array $payload): array
{
$endpoint = '[URL_WITH_CREDENTIALS] null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
// Don't waste time searching for single character strings.
if (\strlen($name) <= 1) {
return null;
}
$cacheKey = $this->getCacheKey($name, $userId);
$result = Cache::remember($cacheKey, 60, function () use ($name, $userId) {
$payload = $this->payloadBuilder->generateSearchContactsByNamePayload(
$name,
$this->getContactFields()
);
$hsContacts = $this->client->getPaginatedData($payload, 'contact');
if (empty($hsContacts['results'])) {
return false;
}
$contact = $this->importContact($hsContacts['results'][0]);
if ($contact === null) {
return false;
}
$account = $contact->account;
$countryCode = $contact->country_code ?? $account->country_code ?? null;
try {
$hsOpportunities = $this->findOpportunities(
$account ? $account->crm_provider_id : null,
$contact->crm_provider_id,
$userId
);
} catch (Exception $e) {
$hsOpportunities = [];
}
$opportunity = null;
$stage = null;
if (! empty($hsOpportunities)) {
// Persist this remote object.
$opportunity = $this->syncOpportunity($hsOpportunities[0]['crmId']);
$stage = $opportunity?->getStage();
}
return [
null,
$account,
$opportunity,
$contact,
$stage,
$countryCode,
];
});
return is_array($result) ? $result : null;
}
private function convertActivityAssociations(Activity $activity): array
{
return [
'contactIds' => $this->getParticipantsIds($activity),
'companyIds' => $activity->hasAccount() ? [$activity->account->crm_provider_id] : [],
'dealIds' => $activity->hasOpportunity() ? [$activity->opportunity->crm_provider_id] : [],
'ownerIds' => [],
];
}
private function getParticipantsIds(Activity $activity): array
{
$attendees = [];
$participantRepository = app(ParticipantRepository::class);
$participants = $participantRepository->getParticipantsWhoEnteredMeeting($activity);
foreach ($participants as $participant) {
if ($participant->user_id || $participant->isCoach()) {
continue;
}
$contact = $participant->contact()->first();
if ($contact && $contact->crm_provider_id) {
$attendees[] = $contact->crm_provider_id;
} else {
if (! empty($participant->name)) {
$attendeeData = $this->fetchMissingAttendeeInfo($participant);
}
if (! empty($attendeeData['id'])) {
$attendees[] = $attendeeData['id'];
}
}
}
if ($activity->hasContact()) {
$attendees[] = $activity->contact->crm_provider_id;
}
return array_unique($attendees);
}
private function fetchMissingAttendeeInfo(Participant $participant): array
{
// Check if we need to look inside an account context.
$activity = $participant->getActivity();
$companyId = $activity->hasAccount() ? $activity->getAccount()->crm_provider_id : null;
// First check the local data.
/** @var Contact[] $contacts */
$contacts = $this->team->contacts()
->with('account')
->where('name', $participant->name)
->whereNotNull('email')
->get();
foreach ($contacts as $contact) {
// If we have a company in scope, check the contact is associated to it.
if (
$companyId !== null
&& ($contact->account_id === null || $companyId !== $contact->account->crm_provider_id)
) {
continue;
}
return [
'id' => $contact->crm_provider_id,
'email' => $contact->email,
];
}
$payload = $this->generateNameSearchPayload($participant->name, 0, 20);
try {
$response = $this->client->getNewInstance()->crm()->contacts()->searchApi()->doSearch($payload);
// TODO add some logic to choose the most suitable contact if multiple
foreach ($response['results'] as $object) {
$properties = $object['properties'];
if (empty($object['properties']) === false) {
// Check the company matches the contact.
// Todo: Move this check inside the API search.
if ($companyId !== null && $companyId !== $properties['associatedcompanyid']) {
continue;
}
return [
'id' => $object['id'],
'email' => $properties['email'],
];
}
}
} catch (Exception $e) {
$this->logger->warning('[' . $this->getDisplayName() . '] Search failed', [
'teamId' => $this->team->id_string,
'request' => $payload,
'reason' => $e->getMessage(),
]);
}
return [];
}
/**
* Store transcripts as note engagement.
*
* @throws Exception
*/
public function createTranscriptNotes(Activity $activity): void
{
// For HS no need to check if Crm profile - Log Notes field is enabled
// We only check if store_transcript toggle is enabled on crm profile.
$engagement = [
'active' => true,
'ownerId' => $this->profile->crm_provider_id,
'timestamp' => $activity->created_at->tz($activity->user->timezone)->getTimestamp() * 1000,
'type' => 'NOTE',
];
// Generate activity transcription.
$transcriptionData = $this->generateTranscription($activity);
// Truncate Notes with max notes length because transcription text could be very long.
$transcripts = mb_strimwidth($transcriptionData, 0, static::ENGAGEMENT_BODY_MAX_LENGTH);
$metadata = [
'body' => $transcripts,
];
$associations = $this->convertActivityAssociations($activity);
try {
$hsEngagement = $this->client
->getInstance()
->engagements()
->create($engagement, $associations, $metadata);
$this->logCrmEngagementManipulation(self::ACTION_CREATE, $engagement, $metadata, $associations);
$noteId = $hsEngagement->data->engagement->id;
// Store crm logged id in transcription.
$transcription = $activity->getTranscription();
$transcription->crm_activity_id = $noteId;
$transcription->save();
} catch (Exception $e) {
Sentry::captureException($e);
}
}
/*
* @inheritdoc
*/
public function updateRecord(string $objectType, string $objectId, array $data, array $headers = []): void
{
$payload = [
'properties' => $data,
];
try {
switch ($objectType) {
case FieldData::OBJECT_OPPORTUNITY:
$this->client->getNewInstance()->crm()->deals()->basicApi()->update($objectId, $payload);
break;
case FieldData::OBJECT_CONTACT:
$this->client->getNewInstance()->crm()->contacts()->basicApi()->update($objectId, $payload);
break;
case Fi...
|
PhpStorm
|
faVsco.js – Service.php
|
NULL
|
9132
|
|
9131
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9131
|
|
9130
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9130
|
|
9129
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9129
|
|
9128
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9128
|
|
9127
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9127
|
|
9126
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9126
|
|
9125
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
SlackFileEditViewGoHistoryWindowHelpAPP (-zsh)>0 lbl.• 84Support Daily - now100% C8Fri 8 May 15:07:33DOCKERDEV (docker)882APP (-zsh)883-zshPHPruntime:8.3.30Running analysis on 7 cores with 10 files per process.Parallel runner is an experimental feature and may be unstable, use it at your own risk. Feedback highly appreciated!Loadedconfig default from"-php-cs-fixer.dist.php"5663/5663100%Fixed 0 of 5663 files in 42.875 seconds, 60.00 MB memory usedWhat's next:Try Docker Debug for seamless, persistent debugging tools in any container or image → docker debug docker_lamp_1Learn moreat [URL_WITH_CREDENTIALS] ~/jiminny/app (master) $ git pullremote: Enumerating objects: 15,remote: Counting objects: 100% (15/15), done.remote: Compressing objects: 100% (2/2), done.remote: Total 15 (delta 13), reused 15 (delta 13), pack-reused 0 (from 0)Unpacking objects: 100% (15/15), 1.28 KiB | 72.00 KiB/s, done.From github.com:jiminny/appc57e71e763..8743fea32e* [new branch]Already up to date.lukas@Lukas-Kovaliks-MacBook-Pro-Jiminny ~/jiminny/app (master) $JY-20606-desktop-app-recall-> origin/JY-20606-desktop-app-recallJY-20819-increase-download-transctip-rate-limit -> origin/JY-20819-increase-download-transctip-rate-limitSupport Dailynow - 15:00-15:15• Support Daily - 2026/05/... +1 moreC Join Google MeetAPP...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9125
|
|
9124
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9124
|
|
9123
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use ChaseConey\LaravelDatadogHelper\Datadog;
use Illuminate\Contracts\Cache\Repository;
use Illuminate\Support\Facades\App;
use Jiminny\Contracts\Services\Crm\SyncCrmEntitiesInterface;
use Jiminny\Events\Crm\ProspectUpdated;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Crm\Profile;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Jiminny\Repositories\Crm\ContactRoleRepository;
use Jiminny\Repositories\Crm\OpportunityRepository;
use Jiminny\Services\Crm\CrmObjects\Validators\StaleRecordValidator;
use Jiminny\Services\Crm\Salesforce\OpportunityMatcher\MatchBusinessAccount;
use Psr\Log\LoggerInterface;
class ProspectCache
{
public const string PROSPECT_TYPE_EMAIL = 'email';
public const string PROSPECT_TYPE_PHONE = 'phone';
public const string PROSPECT_TYPE_DOMAIN = 'domain';
private const int TTL_SECONDS = 900;
private const int TTL_SECONDS_DEV = 30;
private const string DATADOG_STAT_NAME = 'jiminny.crm.prospect_cache_lookup';
private const string LOOKUP_RESULT_INTERNAL = 'internal';
private const string LOOKUP_RESULT_CACHE = 'cache';
private const string LOOKUP_RESULT_DB = 'db';
private const string LOOKUP_RESULT_MISS = 'miss';
public function __construct(
private readonly FindsProspectInterface $dbCache,
private readonly Repository $cache,
private readonly OpportunityRepository $opportunityRepository,
private readonly EmailHelper $emailHelper,
private readonly LoggerInterface $logger,
private readonly StaleRecordValidator $staleRecordValidator,
) {
}
/**
* @return null|array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* }
*/
public function findByProspectIdentifier(
Configuration $configuration,
?Profile $profile,
string $identifierType,
string $identifierValue,
?int $userId = null,
?SyncCrmEntitiesInterface $crmService = null
): ?array {
$cachedValue = $this->get($configuration, $identifierValue, $userId);
if ($cachedValue !== null) {
$this->sendDatadogStats(self::LOOKUP_RESULT_CACHE, $configuration->getProviderName());
return $cachedValue;
}
if ($identifierType == self::PROSPECT_TYPE_EMAIL
&& $this->emailHelper->isCompanyEmail($configuration->getTeam(), $identifierValue)
) {
// Set the cache to avoid querying the database for internal participants
$prospectData = [null, null, null, null, null, null];
$this->set($configuration, $identifierValue, $prospectData, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_INTERNAL, $configuration->getProviderName());
return $prospectData;
}
$dbCache = $this->dbCache->findProspect($configuration, [$identifierType => $identifierValue]);
if (empty(array_filter($dbCache))) {
$this->sendDatadogStats(self::LOOKUP_RESULT_MISS, $configuration->getProviderName());
return null;
}
$dbCache['contact'] = $this->staleRecordValidator->filterStale($dbCache['contact'], $crmService);
$dbCache['lead'] = $this->staleRecordValidator->filterStale($dbCache['lead'], $crmService);
if ($dbCache['contact'] instanceof Contact) {
$account = $dbCache['contact']->getAccount();
$dbCache['account'] = $account;
$opportunity = $this->findOpportunityInContactRoles(
$configuration,
$profile,
$dbCache['contact']->getId()
);
$opportunity = $this->staleRecordValidator->filterStale($opportunity, $crmService);
if ($opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Found opportunities by contact roles', [
'opportunity_id' => $opportunity->getId(),
]);
$dbCache['account'] = $opportunity->getAccount();
} elseif ($account instanceof Account) {
$opportunity = $this->getOpportunityFromDatabase(
configuration: $configuration,
account: $account,
contactId: $dbCache['contact']->getId(),
userId: $userId
);
}
$dbCache['opportunity'] = $opportunity;
$dbCache['account'] = $this->staleRecordValidator->filterStale($dbCache['account'], $crmService);
$dbCache['stage'] = $dbCache['opportunity']?->getStage();
}
/**
* @IMPORTANT The keys must always be in this exact order
*
* @var array{
* ?Lead,
* ?Account,
* ?Opportunity,
* ?Contact,
* ?Stage,
* string|null
* } $result
*/
$result = [
$dbCache['lead'] ?? null,
$dbCache['account'] ?? null,
$dbCache['opportunity'] ?? null,
$dbCache['contact'] ?? null,
$dbCache['stage'] ?? null,
null,
];
$this->set($configuration, $identifierValue, $result, $userId);
$this->sendDatadogStats(self::LOOKUP_RESULT_DB, $configuration->getProviderName());
return $result;
}
public function findDomainMatch(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
$cachedValue = $this->get(
configuration: $configuration,
identifier: $identifier,
userId: $userId
);
if ($cachedValue !== null) {
$this->sendDatadogStats(
self::LOOKUP_RESULT_CACHE,
$configuration->getProviderName()
);
return $cachedValue;
}
// Log cache miss
$this->logger->info('[Prospect match] Cache miss', [
'identifier_type' => self::PROSPECT_TYPE_DOMAIN,
'identifier' => $identifier,
'crm' => $configuration->getProviderName(),
]);
// not in the cache
return null;
}
public function set(Configuration $configuration, string $identifier, array $prospectData, ?int $userId = null): void
{
$this->cache->tags($this->getTags($configuration, $identifier))->put(
$this->generateKey($configuration, $identifier, $userId),
$prospectData,
$this->getCacheTtl()
);
}
public function handleProspectUpdated(ProspectUpdated $event): void
{
$prospect = $event->getProspect();
$configuration = $prospect->getCrmConfiguration();
if ($configuration === null) {
return;
}
if ($prospect->getEmail() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getEmail())])->flush();
}
if ($prospect->getPhone() !== null) {
$normalizedPhone = $this->normalizePhoneNumber($prospect->getPhone());
$this->cache->tags([$this->generateProspectTag($configuration, $normalizedPhone)])->flush();
}
if ($prospect->getName() !== null) {
$this->cache->tags([$this->generateProspectTag($configuration, $prospect->getName())])->flush();
}
}
public function normalizePhoneNumber(string $phone): string
{
// Remove all non-digit characters first
$digitsOnly = preg_replace('/[^\d]/', '', $phone);
// Remove a single leading zero if present
$digitsOnly = ltrim($digitsOnly, '0');
// Add E.164 prefix
return '+' . $digitsOnly;
}
private function get(Configuration $configuration, string $identifier, ?int $userId = null): ?array
{
return $this->cache->tags($this->getTags($configuration, $identifier))
->get($this->generateKey($configuration, $identifier, $userId));
}
private function generateKey(Configuration $configuration, string $identifier, ?int $userId = null): string
{
$keySuffix = $userId === null ? '' : ':user:' . $userId;
return hash('sha256', 'crm:' . $configuration->getId() . ':prospect:' . $identifier . $keySuffix);
}
private function sendDatadogStats(string $result, string $crm): void
{
Datadog::increment(self::DATADOG_STAT_NAME, 1, [
'result' => $result,
'crm' => $crm,
]);
}
private function getCacheTtl(): int
{
if (! App::environment('production', 'production-eu')) {
return self::TTL_SECONDS_DEV;
}
return self::TTL_SECONDS;
}
private function findOpportunityInContactRoles(
Configuration $configuration,
?Profile $profile,
int $contactId
): ?Opportunity {
$contactRoleRepository = app(ContactRoleRepository::class);
$contactRoles = $contactRoleRepository->getByCrmContactId(
$configuration,
$contactId,
);
if (! $contactRoles->isEmpty()) {
$opportunityId = app(MatchBusinessAccount::class)->resolve(
$contactRoles,
$profile?->getCrmProviderId(),
);
$opportunity = $this->opportunityRepository->find($opportunityId);
}
return $opportunity ?? null;
}
private function getOpportunityFromDatabase(
Configuration $configuration,
Account $account,
int $contactId,
?int $userId = null
): ?Opportunity {
$opportunity = null;
if ($userId) {
$this->logger->info('ProspectCache - Searching DB for opportunity by owner', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'owner_id' => $userId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityOwner(
$configuration,
$account,
$userId,
$contactId
);
}
if (! $opportunity instanceof Opportunity) {
$this->logger->info('ProspectCache - Fallback DB opportunity search', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
]);
$opportunity = $this->opportunityRepository->findOneByAccountAndOpportunityAssignmentRule(
$configuration,
$account,
$contactId
);
}
$this->logger->info('ProspectCache - Opportunity DB search results', [
'account_id' => $account->getId(),
'contact_id' => $contactId,
'opportunity_id' => $opportunity?->getId(),
]);
return $opportunity;
}
private function generateProspectTag(Configuration $configuration, string $identifier): string
{
return 'prospect:' . $configuration->getId() . ':' . $identifier;
}
private function getTags(Configuration $configuration, string $identifier): array
{
return ['prospect_cache', $this->generateProspectTag($configuration, $identifier)];
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – ProspectCache.php
|
NULL
|
9123
|
|
9122
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
19
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:21:15] local.INFO: [Hubspot] DEBUG Getting headers {
"headers":{
"Date":["Thu,07 May 2026 14:21:15 GMT"],
"Content-Type":["application/json;charset=utf-8"],
"Transfer-Encoding":["chunked"],
"Connection":["keep-alive"],
"CF-Ray":["9f80deb8db60dc3a-SOF"],
"CF-Cache-Status":["DYNAMIC"],
"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],
"Vary":["origin,
accept-encoding"],
"access-control-allow-credentials":["false"],
"server-timing":["hcid;desc=\"019e02d0-6fd8-7812-bdba-885b7ccb3ee3\",
cfr;desc=\"9f80deb8e7c6dc3a-IAD\""],
"x-content-type-options":["nosniff"],
"x-hubspot-correlation-id":["019e02d0-6fd8-7812-bdba-885b7ccb3ee3"],
"Set-Cookie":["__cf_bm=SIUrtdQgXVrik50pdqF6hZVYKhzTnQBidvMabeCtm0Y-1778163675-[IP_ADDRESS]-rI.ZggtDKxTge5zr8_2gbBfWMQQ.ufZEXDZyHz2mBUFdzdo2gTHEsOkXMSEShjK0hGYxNhUGM1ZoBpX7BcFZcHEjA7Cs_.SMUhUnd2nYjko; path=/; expires=Thu,
07-May-26 14:51:15 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],
"Report-To":["{
\"endpoints\":[{
\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=NYAlsVTP0fYm32qrSDjxYE4sd2RWRqiSp3wHsmdEgZlzoYdxI%2BIxVpHmsKn3O%2BKVA3mFIJ2m7YRECDGSM%2BW2IYTzo6FM4%2BdUIjURO8srzKSvJgZ%2BQ6R79arKQw3uHLlX\"}],
\"group\":\"cf-nel\",
\"max_age\":604800}"],
"NEL":["{
\"success_fraction\":0.01,
\"report_to\":\"cf-nel\",
\"max_age\":604800}"],
"Server":["cloudflare"]}} {
"correlation_id":"95236535-ec98-4541-b92a-adfa73b69eab",
"trace_id":"c7ab8365-903f-46d4-9403-0e5b551e3545"}
Sync Changes
Hide This Notification
Code changed:
Hide
8
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm;
use Jiminny\Contracts\Services\Crm\ConnectionStateInterface;
use Jiminny\Contracts\Services\Crm\MatchCrmEntitiesWithCacheInterface;
use Jiminny\Contracts\Services\Crm\ServiceInterface;
use Jiminny\Exceptions\ApplicationException;
use Jiminny\Models\Account;
use Jiminny\Models\Contact;
use Jiminny\Models\Crm\Configuration;
use Jiminny\Models\Lead;
use Jiminny\Models\Opportunity;
use Jiminny\Models\Stage;
use Psr\Log\LoggerInterface;
class CachedCrmServiceDecorator implements MatchCrmEntitiesWithCacheInterface
{
private ?ServiceInterface $crmService = null;
private ProspectCache $prospectCache;
private LoggerInterface $logger;
private ?Configuration $configuration;
public function __construct(
ProspectCache $prospectCache,
LoggerInterface $logger
) {
$this->prospectCache = $prospectCache;
$this->logger = $logger;
$this->configuration = null;
}
public function setCrmService(?ServiceInterface $crmService = null): void
{
$this->crmService = $crmService;
}
public function setConfiguration(Configuration $configuration): void
{
$this->configuration = $configuration;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchExactlyByEmail(string $email, ?int $userId = null): ?array
{
if (! filter_var($email, FILTER_VALIDATE_EMAIL)) {
$this->logger->warning('[Prospect match] Invalid email address', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_EMAIL,
'identifier' => $email,
]);
// The email address of the prospect is invalid.
// Return null, so we can try to match by phone or name.
return null;
}
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_EMAIL,
identifierValue: $email,
userId: $userId
);
}
public function matchByDomain(string $email, ?int $userId = null): ?array
{
if (! $this->crmService instanceof MatchDomainByEmailInterface) {
$this->logger->info('[Prospect match] Service does not support matching by domain', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'crm' => $this->crmService?->getDisplayName() ?? 'Not set',
'email' => $email,
]);
return null;
}
$domain = $this->crmService->getDomain($email);
if (empty($domain)) {
$this->logger->info('[Prospect match] Empty domain name', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'email' => $email,
]);
return null;
}
$this->logger->info('[Prospect match] Resolved company domain from email', [
'email' => $email,
'domain' => $domain,
]);
$configuration = $this->getConfiguration();
// try the cache
$cachedValue = $this->prospectCache->findDomainMatch(
configuration: $configuration,
identifier: $domain,
userId: $userId
);
if ($cachedValue !== null) {
return $cachedValue;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]);
$apiResult = $this->crmService->matchByDomain(domain: $domain, userId: $userId);
if (empty($apiResult)) {
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => ProspectCache::PROSPECT_TYPE_DOMAIN,
'identifier' => $domain,
]
);
// cache the miss with empty prospect data
$apiResult = [null, null, null, null, null, null];
}
$this->prospectCache->set(
configuration: $configuration,
identifier: $domain,
prospectData: $apiResult,
userId: $userId
);
return $apiResult;
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
* }
*/
public function matchByName(string $name, ?int $userId = null): ?array
{
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => 'name',
'identifier' => $name,
]);
return null;
}
return $this->crmService->matchByName(
name: $name,
userId: $userId
);
}
/**
* @return null|array{
* Lead|null,
* Account|null,
* Opportunity|null,
* Contact|null,
* Stage|null,
* string|null
*}
*/
public function matchByPhone(string $phone, ?string $rawPhoneNumber = null, ?int $userId = null): ?array
{
return $this->matchByProspectIdentifier(
identifierType: ProspectCache::PROSPECT_TYPE_PHONE,
identifierValue: $phone,
identifierSecondaryValue: $rawPhoneNumber,
userId: $userId
);
}
/**
* @throws ApplicationException
*/
private function matchByProspectIdentifier(
string $identifierType,
string $identifierValue,
?string $identifierSecondaryValue = null,
?int $userId = null,
): ?array {
$configuration = $this->getConfiguration();
$profile = $this->crmService->profile ?? null;
// Normalize phone number BEFORE cache lookup
if ($identifierType === ProspectCache::PROSPECT_TYPE_PHONE) {
$identifierValue = $this->prospectCache->normalizePhoneNumber($identifierValue);
}
$prospectData = $this->prospectCache->findByProspectIdentifier(
configuration: $configuration,
profile: $profile,
identifierType: $identifierType,
identifierValue: $identifierValue,
userId: $userId,
crmService: $this->crmService
);
if ($prospectData !== null) {
$this->logger->info('[Prospect match] Cache / local search hit', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (empty(array_filter($prospectData))) {
$this->logger->info('[Prospect match] cached empty result - no API calls, try next matching method', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
/**
* @IMPORTANT This is a cached empty result, i.e. there's no prospect with this email.
* We cache the empty result, so we don't keep querying the database and the API
* for non-existing prospects.
* However, we need to return null from this method
* in order to trigger the next matching method (e.g. matchByPhone or matchByName).
* This is because an array with null values is not considered empty.
*/
return null;
}
return $prospectData;
}
$this->logger->info('[Prospect match] Cache miss, calling the API', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
if (! $this->isConnected()) {
$this->logger->info('[Prospect match] Service is not connected, remote search is currently not available', [
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]);
return null;
}
/** @var 'email'|'phone' $identifierType */
$apiResult = match($identifierType) {
ProspectCache::PROSPECT_TYPE_EMAIL => $this->crmService->matchExactlyByEmail(
email: $identifierValue,
userId: $userId
),
ProspectCache::PROSPECT_TYPE_PHONE => $this->crmService->matchByPhone(
phone: $identifierValue,
rawPhoneNumber: $identifierSecondaryValue,
userId: $userId
),
};
$cachedResult = $apiResult;
if (empty($apiResult)) {
// In case the result is null or an empty array,
// cache the missing prospect, so we don't keep calling the API
$this->logger->info(
'[Prospect match] API returned empty result, caching the miss with empty prospect data',
[
'identifier_type' => $identifierType,
'identifier' => $identifierValue,
]
);
$cachedResult = [null, null, null, null, null, null];
}
// Set the cache even if the result is empty,
// so we don't keep querying the database and the API
$this->prospectCache->set($configuration, $identifierValue, $cachedResult, $userId);
return $apiResult;
}
private function isConnected(): bool
{
if ($this->crmService instanceof ConnectionStateInterface) {
return $this->crmService->isConnected();
}
return $this->crmService !== null;
}
/**
* @throws ApplicationException
*/
private function getConfiguration(): Configuration
{
if ($this->configuration) {
return $this->configuration;
}
if ($this->crmService?->getConfiguration()) {
return $this->crmService->getConfiguration();
}
throw new ApplicationException('Missing team configuration. Cannot set team prospect cache');
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – CachedCrmServiceDecorator.php
|
NULL
|
9122
|