@friggframework/core 2.0.0--canary.703.12b980b.0 → 2.0.0--canary.707.df80bfd.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (308) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/CLAUDE.md +28 -0
  3. package/README.md +105 -0
  4. package/application/commands/integration-commands.js +20 -10
  5. package/application/commands/scheduler-commands.js +11 -7
  6. package/application/commands/user-commands.js +17 -5
  7. package/application/index.js +6 -2
  8. package/core/Worker.js +31 -7
  9. package/core/create-handler.js +9 -0
  10. package/credential/repositories/credential-repository-documentdb.js +34 -0
  11. package/credential/repositories/credential-repository-interface.js +15 -0
  12. package/credential/repositories/credential-repository-mongo.js +23 -0
  13. package/credential/repositories/credential-repository-postgres.js +28 -0
  14. package/credential/use-cases/credential-operations-for-user.js +202 -0
  15. package/credential/use-cases/reauthorize-credential-for-user.js +73 -0
  16. package/database/config.js +48 -24
  17. package/database/documentdb-encryption-service.js +9 -22
  18. package/database/documentdb-utils.js +2 -2
  19. package/database/encryption/README.md +78 -14
  20. package/database/encryption/documentdb-encryption-service.md +78 -1
  21. package/database/encryption/encryption-config.js +219 -0
  22. package/database/encryption/encryption-schema-registry.js +121 -24
  23. package/database/encryption/field-encryption-service.js +69 -5
  24. package/database/encryption/integration-mapping-encryption.js +1 -1
  25. package/database/encryption/test-support/fake-ciphertext.js +15 -0
  26. package/database/organization-where.js +18 -0
  27. package/database/prisma.js +15 -38
  28. package/database/unique-violation.js +25 -0
  29. package/database/use-cases/check-encryption-health-use-case.js +43 -52
  30. package/errors/index.js +0 -4
  31. package/extensions/bootstrap-runner.js +43 -0
  32. package/extensions/extension-loader.js +230 -0
  33. package/extensions/index.js +44 -0
  34. package/extensions/initialize-app.js +123 -0
  35. package/extensions/prisma-composer.js +270 -0
  36. package/extensions/route-mounter.js +103 -0
  37. package/extensions/schema-composer.js +188 -0
  38. package/generated/prisma-mongodb/edge.js +33 -42
  39. package/generated/prisma-mongodb/index-browser.js +30 -39
  40. package/generated/prisma-mongodb/index.d.ts +3187 -2005
  41. package/generated/prisma-mongodb/index.js +33 -42
  42. package/generated/prisma-mongodb/package.json +1 -1
  43. package/generated/prisma-mongodb/schema.prisma +86 -59
  44. package/generated/prisma-mongodb/wasm.js +33 -42
  45. package/generated/prisma-postgresql/edge.js +33 -42
  46. package/generated/prisma-postgresql/index-browser.js +30 -39
  47. package/generated/prisma-postgresql/index.d.ts +3380 -2177
  48. package/generated/prisma-postgresql/index.js +33 -42
  49. package/generated/prisma-postgresql/package.json +1 -1
  50. package/generated/prisma-postgresql/schema.prisma +81 -57
  51. package/generated/prisma-postgresql/wasm.js +33 -42
  52. package/handlers/WEBHOOKS.md +0 -29
  53. package/handlers/app-definition-loader.js +128 -19
  54. package/handlers/app-handler-helpers.js +27 -8
  55. package/handlers/backend-utils.js +31 -25
  56. package/handlers/integration-event-dispatcher.js +3 -7
  57. package/handlers/middleware/admin-auth.js +14 -1
  58. package/handlers/routers/auth.js +46 -10
  59. package/handlers/routers/health.js +13 -4
  60. package/handlers/routers/integration-defined-routers.js +144 -92
  61. package/handlers/routers/integration-webhook-routers.js +100 -50
  62. package/handlers/workers/integration-defined-workers.js +5 -2
  63. package/index.js +66 -16
  64. package/infrastructure/scheduler/index.js +19 -6
  65. package/infrastructure/scheduler/netlify-scheduler-adapter.js +216 -0
  66. package/infrastructure/scheduler/scheduled-job-repository.js +118 -0
  67. package/infrastructure/scheduler/scheduler-service-factory.js +55 -7
  68. package/integrations/index.js +1 -14
  69. package/integrations/integration-base.js +2 -163
  70. package/integrations/integration-router.js +132 -102
  71. package/integrations/repositories/integration-mapping-repository-documentdb.js +0 -50
  72. package/integrations/repositories/integration-mapping-repository-interface.js +0 -15
  73. package/integrations/repositories/integration-mapping-repository-mongo.js +0 -29
  74. package/integrations/repositories/integration-mapping-repository-postgres.js +0 -30
  75. package/integrations/repositories/integration-mapping-repository.js +0 -29
  76. package/integrations/repositories/integration-not-found.js +14 -0
  77. package/integrations/repositories/integration-repository-documentdb.js +37 -9
  78. package/integrations/repositories/integration-repository-interface.js +17 -4
  79. package/integrations/repositories/integration-repository-mongo.js +64 -96
  80. package/integrations/repositories/integration-repository-postgres.js +63 -81
  81. package/integrations/repositories/process-repository-mongo.js +1 -1
  82. package/integrations/schedule-config.js +80 -0
  83. package/integrations/tests/doubles/test-integration-repository.js +12 -1
  84. package/integrations/use-cases/create-integration.js +56 -31
  85. package/integrations/use-cases/delete-integration-for-user.js +4 -4
  86. package/integrations/use-cases/dispatch-ongoing-syncs.js +100 -0
  87. package/integrations/use-cases/get-integration-for-user.js +2 -4
  88. package/integrations/use-cases/get-integration-instance.js +4 -4
  89. package/integrations/use-cases/get-integrations-for-user.js +79 -39
  90. package/integrations/use-cases/get-possible-integrations.js +2 -7
  91. package/integrations/use-cases/index.js +7 -1
  92. package/integrations/use-cases/integration-operations-for-user.js +256 -0
  93. package/integrations/use-cases/resolve-integration-ownership.js +177 -0
  94. package/integrations/use-cases/update-integration.js +4 -4
  95. package/integrations/utils/map-integration-dto.js +43 -14
  96. package/management-api/create-management-api-router.js +49 -0
  97. package/management-api/error-response.js +116 -0
  98. package/management-api/management-api-config.js +151 -0
  99. package/management-api/meta-router.js +76 -0
  100. package/management-api/openapi/build-openapi.js +144 -0
  101. package/management-api/openapi/components.js +415 -0
  102. package/management-api/openapi/v1-operations.js +83 -0
  103. package/management-api/openapi/v2-operations.js +264 -0
  104. package/management-api/route-registry.js +411 -0
  105. package/management-api/test-support/http-client.js +39 -0
  106. package/management-api/use-cases/get-management-api-meta.js +57 -0
  107. package/management-api/v1-deprecation.js +120 -0
  108. package/management-api/v2/create-v2-router.js +85 -0
  109. package/management-api/v2/dependencies.js +281 -0
  110. package/management-api/v2/dto.js +143 -0
  111. package/management-api/v2/handlers/authorization.js +94 -0
  112. package/management-api/v2/handlers/credentials.js +33 -0
  113. package/management-api/v2/handlers/entities.js +77 -0
  114. package/management-api/v2/handlers/integrations.js +128 -0
  115. package/management-api/v2/handlers/proxy.js +34 -0
  116. package/management-api/v2/request.js +85 -0
  117. package/management-api/v2/test-support/fake-dependencies.js +103 -0
  118. package/modules/domain/authorization-session.js +144 -0
  119. package/modules/entity-scope.js +15 -0
  120. package/modules/entity-type-registry.js +311 -0
  121. package/modules/index.js +14 -0
  122. package/modules/module-factory.js +12 -0
  123. package/modules/module.js +53 -2
  124. package/modules/proxy/proxy-bases.js +169 -0
  125. package/modules/proxy/proxy-errors.js +31 -0
  126. package/modules/proxy/proxy-path.js +183 -0
  127. package/modules/proxy/proxy-policy.js +277 -0
  128. package/modules/repositories/authorization-session-repository-documentdb.js +112 -0
  129. package/modules/repositories/authorization-session-repository-factory.js +31 -0
  130. package/modules/repositories/authorization-session-repository-interface.js +47 -0
  131. package/modules/repositories/authorization-session-repository-prisma.js +87 -0
  132. package/modules/repositories/entity-not-found.js +18 -0
  133. package/modules/repositories/module-repository-documentdb.js +51 -6
  134. package/modules/repositories/module-repository-interface.js +19 -2
  135. package/modules/repositories/module-repository-mongo.js +67 -74
  136. package/modules/repositories/module-repository-postgres.js +66 -74
  137. package/modules/repositories/module-repository.js +2 -1
  138. package/modules/requester/proxy-request.js +245 -0
  139. package/modules/requester/requester.js +35 -5
  140. package/modules/scope-config.js +192 -0
  141. package/modules/scope-policy.js +112 -0
  142. package/modules/scope-resolution.js +288 -0
  143. package/modules/scope-visibility.js +247 -0
  144. package/modules/tests/doubles/in-memory-authorization-session-repository.js +45 -0
  145. package/modules/tests/doubles/ownership-matching.js +18 -0
  146. package/modules/use-cases/authorize-entity-for-user.js +61 -0
  147. package/modules/use-cases/create-entity-from-credential.js +113 -0
  148. package/modules/use-cases/entity-operations-for-user.js +162 -0
  149. package/modules/use-cases/entity-types.js +139 -0
  150. package/modules/use-cases/execute-entity-proxy-request.js +331 -0
  151. package/modules/use-cases/get-authorization-requirements.js +100 -0
  152. package/modules/use-cases/get-entities-for-user.js +26 -13
  153. package/modules/use-cases/get-entity-module-for-user.js +113 -0
  154. package/modules/use-cases/get-entity-options-by-id.js +10 -4
  155. package/modules/use-cases/get-entity-options-by-type.js +1 -1
  156. package/modules/use-cases/get-module-instance-from-type.js +1 -1
  157. package/modules/use-cases/get-module.js +10 -4
  158. package/modules/use-cases/manage-access.js +21 -0
  159. package/modules/use-cases/multi-step-authorization.js +329 -0
  160. package/modules/use-cases/process-authorization-callback.js +53 -19
  161. package/modules/use-cases/refresh-entity-options.js +10 -4
  162. package/modules/use-cases/test-module-auth.js +10 -4
  163. package/package.json +6 -7
  164. package/prisma-mongodb/schema.prisma +86 -59
  165. package/prisma-postgresql/migrations/20261003000000_add_authorization_session/migration.sql +28 -0
  166. package/prisma-postgresql/migrations/20261015000000_add_organization_membership/migration.sql +26 -0
  167. package/prisma-postgresql/migrations/20261016000000_add_entity_integration_organization/migration.sql +25 -0
  168. package/prisma-postgresql/migrations/20261017000000_add_scheduled_job/migration.sql +28 -0
  169. package/prisma-postgresql/schema.prisma +81 -57
  170. package/providers/index.js +23 -0
  171. package/providers/resolve-provider.js +93 -0
  172. package/providers/runtime-detection.js +124 -0
  173. package/queues/index.js +25 -0
  174. package/queues/providers/index.js +11 -0
  175. package/queues/providers/netlify-background-provider.js +150 -0
  176. package/queues/providers/qstash-queue-provider.js +219 -0
  177. package/queues/providers/sqs-queue-provider.js +70 -0
  178. package/queues/queue-client-interface.js +55 -0
  179. package/queues/queue-message-auth.js +193 -0
  180. package/queues/queue-provider-factory.js +101 -0
  181. package/queues/queue-provider.js +65 -0
  182. package/queues/queuer-util.js +2 -9
  183. package/queues/sqs-queue-client.js +81 -0
  184. package/types/index.d.ts +2 -0
  185. package/types/modules/index.d.ts +214 -0
  186. package/types/user/index.d.ts +134 -0
  187. package/user/adopter-jwt-config.js +177 -0
  188. package/user/adopter-jwt-errors.js +59 -0
  189. package/user/adopter-token-verifier.js +122 -0
  190. package/user/app-user-helpers.js +97 -0
  191. package/user/create-user-authentication.js +64 -0
  192. package/user/membership.js +51 -0
  193. package/user/repositories/organization-membership-record.js +19 -0
  194. package/user/repositories/organization-membership-repository-documentdb.js +106 -0
  195. package/user/repositories/organization-membership-repository-factory.js +42 -0
  196. package/user/repositories/organization-membership-repository-interface.js +57 -0
  197. package/user/repositories/organization-membership-repository-mongo.js +13 -0
  198. package/user/repositories/organization-membership-repository-postgres.js +29 -0
  199. package/user/repositories/organization-membership-repository-prisma.js +81 -0
  200. package/user/repositories/user-repository-documentdb.js +27 -2
  201. package/user/repositories/user-repository-interface.js +18 -0
  202. package/user/repositories/user-repository-mongo.js +24 -0
  203. package/user/repositories/user-repository-postgres.js +18 -0
  204. package/user/tests/doubles/adopter-jwt-fixtures.js +220 -0
  205. package/user/use-cases/authenticate-user.js +7 -1
  206. package/user/use-cases/ensure-organization-membership.js +92 -0
  207. package/user/use-cases/find-individual-users-by-organization.js +54 -0
  208. package/user/use-cases/get-user-from-adopter-jwt.js +95 -124
  209. package/user/use-cases/get-user-from-x-frigg-headers.js +83 -80
  210. package/user/user.js +64 -1
  211. package/errors/mapping-already-exists-error.js +0 -14
  212. package/handlers/workers/integration-triggers.js +0 -25
  213. package/infrastructure/scheduler/recurrence.js +0 -204
  214. package/integrations/define/DESIGN.md +0 -122
  215. package/integrations/define/config.js +0 -98
  216. package/integrations/define/define-app.js +0 -66
  217. package/integrations/define/define-extension.js +0 -154
  218. package/integrations/define/define-integration.js +0 -335
  219. package/integrations/define/examples/deal-alerts.js +0 -140
  220. package/integrations/define/extension-binding.js +0 -174
  221. package/integrations/define/index.js +0 -11
  222. package/integrations/define/json-schema-lite.js +0 -68
  223. package/integrations/define/subscriptions.js +0 -186
  224. package/integrations/define/tests/fixtures/hubspot.js +0 -109
  225. package/integrations/define/tests/fixtures/slack.js +0 -26
  226. package/integrations/define/use.js +0 -39
  227. package/integrations/definitions/README.md +0 -278
  228. package/integrations/definitions/canonical.js +0 -11
  229. package/integrations/definitions/capabilities/AUDIT.md +0 -480
  230. package/integrations/definitions/capabilities/acmeerp.capabilities.json +0 -633
  231. package/integrations/definitions/capabilities/asana.capabilities.json +0 -279
  232. package/integrations/definitions/capabilities/calendly.capabilities.json +0 -385
  233. package/integrations/definitions/capabilities/docusign.capabilities.json +0 -314
  234. package/integrations/definitions/capabilities/fathom.capabilities.json +0 -238
  235. package/integrations/definitions/capabilities/github.capabilities.json +0 -585
  236. package/integrations/definitions/capabilities/hubspot.capabilities.json +0 -822
  237. package/integrations/definitions/capabilities/jira.capabilities.json +0 -391
  238. package/integrations/definitions/capabilities/klaviyo.capabilities.json +0 -503
  239. package/integrations/definitions/capabilities/linear.capabilities.json +0 -378
  240. package/integrations/definitions/capabilities/netsuite.capabilities.json +0 -535
  241. package/integrations/definitions/capabilities/notion.capabilities.json +0 -208
  242. package/integrations/definitions/capabilities/phone.capabilities.json +0 -511
  243. package/integrations/definitions/capabilities/pipedrive.capabilities.json +0 -430
  244. package/integrations/definitions/capabilities/quickbooks.capabilities.json +0 -635
  245. package/integrations/definitions/capabilities/salesforce.capabilities.json +0 -568
  246. package/integrations/definitions/capabilities/shopify.capabilities.json +0 -1128
  247. package/integrations/definitions/capabilities/slack.capabilities.json +0 -373
  248. package/integrations/definitions/capabilities/stripe.capabilities.json +0 -630
  249. package/integrations/definitions/capabilities/webflow.capabilities.json +0 -196
  250. package/integrations/definitions/capabilities/zendesk.capabilities.json +0 -422
  251. package/integrations/definitions/compile.js +0 -80
  252. package/integrations/definitions/config-form.js +0 -137
  253. package/integrations/definitions/examples/acme-erp-quickbooks.definition.json +0 -467
  254. package/integrations/definitions/examples/asana-slack.definition.json +0 -219
  255. package/integrations/definitions/examples/calendly-salesforce.definition.json +0 -459
  256. package/integrations/definitions/examples/docusign-salesforce.definition.json +0 -305
  257. package/integrations/definitions/examples/fathom-hubspot-notion.definition.json +0 -575
  258. package/integrations/definitions/examples/github-linear.definition.json +0 -322
  259. package/integrations/definitions/examples/hubspot-slack.definition.json +0 -427
  260. package/integrations/definitions/examples/klaviyo-hubspot.definition.json +0 -336
  261. package/integrations/definitions/examples/phone-hubspot.definition.json +0 -633
  262. package/integrations/definitions/examples/pipedrive-hubspot.definition.json +0 -136
  263. package/integrations/definitions/examples/pipedrive-phone.definition.json +0 -340
  264. package/integrations/definitions/examples/records/phone-hubspot.definition-version.json +0 -652
  265. package/integrations/definitions/examples/records/phone-hubspot.integration.json +0 -86
  266. package/integrations/definitions/examples/records/phone-hubspot.mappings.json +0 -39
  267. package/integrations/definitions/examples/records/phone-hubspot.workflow-run.json +0 -62
  268. package/integrations/definitions/examples/shopify-klaviyo.definition.json +0 -488
  269. package/integrations/definitions/examples/shopify-netsuite.definition.json +0 -622
  270. package/integrations/definitions/examples/stripe-quickbooks.definition.json +0 -476
  271. package/integrations/definitions/examples/webflow-hubspot-slack.definition.json +0 -262
  272. package/integrations/definitions/examples/zendesk-jira.definition.json +0 -604
  273. package/integrations/definitions/expressions.js +0 -229
  274. package/integrations/definitions/index.js +0 -48
  275. package/integrations/definitions/integration-runtime.js +0 -779
  276. package/integrations/definitions/interpreter.js +0 -104
  277. package/integrations/definitions/manifests.js +0 -177
  278. package/integrations/definitions/renderers/common.js +0 -67
  279. package/integrations/definitions/renderers/html.js +0 -129
  280. package/integrations/definitions/renderers/hubspot.js +0 -59
  281. package/integrations/definitions/renderers/preview.js +0 -154
  282. package/integrations/definitions/renderers/slack.js +0 -146
  283. package/integrations/definitions/repositories/definition-version-repository.js +0 -67
  284. package/integrations/definitions/repositories/workflow-run-repository.js +0 -80
  285. package/integrations/definitions/router.js +0 -170
  286. package/integrations/definitions/runtime.js +0 -268
  287. package/integrations/definitions/schema/capability-manifest.v0.1.schema.json +0 -549
  288. package/integrations/definitions/schema/installation.v0.1.schema.json +0 -130
  289. package/integrations/definitions/schema/integration-definition.v0.1.schema.json +0 -909
  290. package/integrations/definitions/schema/records.md +0 -105
  291. package/integrations/definitions/schema-check.js +0 -58
  292. package/integrations/definitions/scripts/check-manifests.js +0 -220
  293. package/integrations/definitions/scripts/validate.js +0 -66
  294. package/integrations/definitions/steps.js +0 -123
  295. package/integrations/definitions/sync-engine.js +0 -297
  296. package/integrations/definitions/tests/helpers-fake-crm.js +0 -49
  297. package/integrations/definitions/transforms.js +0 -91
  298. package/integrations/definitions/use-cases/definition-use-cases.js +0 -245
  299. package/integrations/definitions/validate.js +0 -436
  300. package/integrations/definitions/versioning.js +0 -176
  301. package/integrations/definitions/webhooks.js +0 -119
  302. package/integrations/integration-types.js +0 -73
  303. package/integrations/triggers.js +0 -244
  304. package/integrations/use-cases/run-trigger-tick.js +0 -155
  305. package/integrations/use-cases/run-trigger.js +0 -77
  306. package/prisma-postgresql/migrations/20261018000000_add_data_defined_integrations/migration.sql +0 -66
  307. package/prisma-postgresql/migrations/20261019000000_workflow_run_waits/migration.sql +0 -7
  308. package/prisma-postgresql/migrations/20261019120000_definition_workspace/migration.sql +0 -5
@@ -1,652 +0,0 @@
1
- {
2
- "$comment": "IntegrationDefinitionVersion row: one per published version, never updated after publish (status may move published -> deprecated -> retired). See schema/records.md.",
3
- "id": "idv_01JB7Q2M4XQ",
4
- "definitionId": "phone-hubspot",
5
- "version": "1.4.0",
6
- "schemaVersion": "0.1",
7
- "status": "published",
8
- "checksum": "sha256:386c69e18a51a7cf061634309eca3e8267c1a59629a388498eddaad9eb44be59",
9
- "changeLevel": "minor",
10
- "previousVersion": "1.3.2",
11
- "notes": "Adds the closed-won thank-you text (off by default) and the Phone deals panel.",
12
- "createdBy": "usr_alex",
13
- "createdAt": "2026-10-17T21:04:11Z",
14
- "publishedAt": "2026-10-17T21:10:02Z",
15
- "document": {
16
- "$schema": "https://friggframework.org/schemas/integration-definition/v0.1.json",
17
- "schemaVersion": "0.1",
18
- "id": "phone-hubspot",
19
- "version": "1.4.0",
20
- "display": {
21
- "label": "Phone ↔ HubSpot",
22
- "description": "Two-way contact sync, call and text logging, missed-call follow-up, closed-won thank-you texts, and Phone activity inside HubSpot.",
23
- "category": "CRM",
24
- "tags": [
25
- "calls",
26
- "sms",
27
- "crm"
28
- ]
29
- },
30
- "modules": {
31
- "phone": {
32
- "module": "phone",
33
- "version": "^2.1"
34
- },
35
- "hubspot": {
36
- "module": "hubspot",
37
- "version": "^1.4"
38
- }
39
- },
40
- "settings": {
41
- "fromNumber": {
42
- "type": "option",
43
- "options": "phone.phoneNumber",
44
- "label": "Phone number to send texts from",
45
- "required": true
46
- }
47
- },
48
- "syncs": [
49
- {
50
- "id": "contacts",
51
- "label": "Contacts",
52
- "description": "HubSpot contacts and Phone contacts stay the same person on both sides.",
53
- "source": "hubspot.contact",
54
- "target": "phone.contact",
55
- "direction": "two_way",
56
- "identity": {
57
- "match": [
58
- {
59
- "source": "properties.email",
60
- "target": "defaultFields.emails[0].value",
61
- "transform": "lowercase",
62
- "key": "email"
63
- },
64
- {
65
- "source": "properties.phone",
66
- "target": "defaultFields.phoneNumbers[0].value",
67
- "transform": "to_e164_phone",
68
- "key": "phone"
69
- }
70
- ],
71
- "onAmbiguous": "skip"
72
- },
73
- "mapping": [
74
- {
75
- "source": "properties.firstname",
76
- "target": "defaultFields.firstName"
77
- },
78
- {
79
- "source": "properties.lastname",
80
- "target": "defaultFields.lastName"
81
- },
82
- {
83
- "source": "properties.company",
84
- "target": "defaultFields.company"
85
- },
86
- {
87
- "source": "properties.email",
88
- "target": "defaultFields.emails[0].value",
89
- "transform": "lowercase"
90
- },
91
- {
92
- "source": "properties.phone",
93
- "target": "defaultFields.phoneNumbers[0].value",
94
- "transform": "to_e164_phone"
95
- },
96
- {
97
- "source": "id",
98
- "target": "externalId",
99
- "direction": "to_target"
100
- }
101
- ],
102
- "backfill": {
103
- "trigger": "userAction",
104
- "pageSize": 100
105
- },
106
- "ongoing": {
107
- "mode": "webhook"
108
- },
109
- "default": "on"
110
- }
111
- ],
112
- "workflows": [
113
- {
114
- "id": "log-call",
115
- "label": "Log calls on the contact",
116
- "purpose": "write",
117
- "default": "on",
118
- "trigger": {
119
- "type": "webhook",
120
- "module": "phone",
121
- "topic": "call.completed"
122
- },
123
- "steps": [
124
- {
125
- "id": "contact",
126
- "use": "links.find",
127
- "with": {
128
- "sync": "contacts",
129
- "key": {
130
- "phone": "$.record.participants[0]"
131
- }
132
- }
133
- },
134
- {
135
- "use": "stop",
136
- "when": "$.steps.contact == null",
137
- "with": {
138
- "reason": "No linked HubSpot contact for this number"
139
- }
140
- },
141
- {
142
- "id": "body",
143
- "use": "template",
144
- "with": {
145
- "id": "call-note"
146
- }
147
- },
148
- {
149
- "id": "engagement",
150
- "use": "hubspot.call.create",
151
- "with": {
152
- "contactId": "$.steps.contact.hubspot",
153
- "properties": {
154
- "hs_call_title": "Phone call ({{record.direction}})",
155
- "hs_call_body": "$.steps.body",
156
- "hs_call_duration": "$.record.duration",
157
- "hs_call_direction": "{{record.direction | upper}}",
158
- "hs_timestamp": "$.record.completedAt"
159
- }
160
- }
161
- }
162
- ]
163
- },
164
- {
165
- "id": "call-summary",
166
- "label": "Add Phone AI call summaries as notes",
167
- "purpose": "write",
168
- "default": "on",
169
- "trigger": {
170
- "type": "webhook",
171
- "module": "phone",
172
- "topic": "call.summary.completed"
173
- },
174
- "steps": [
175
- {
176
- "id": "calls",
177
- "use": "code",
178
- "with": {
179
- "ref": "@acme/phone-steps#participantsForCall@1.0.0",
180
- "with": {
181
- "callId": "$.record.callId"
182
- }
183
- }
184
- },
185
- {
186
- "id": "contact",
187
- "use": "links.find",
188
- "with": {
189
- "sync": "contacts",
190
- "key": {
191
- "phone": "$.steps.calls.participants[0]"
192
- }
193
- }
194
- },
195
- {
196
- "use": "stop",
197
- "when": "$.steps.contact == null",
198
- "with": {
199
- "reason": "No linked contact"
200
- }
201
- },
202
- {
203
- "use": "hubspot.note.create",
204
- "with": {
205
- "contactId": "$.steps.contact.hubspot",
206
- "properties": {
207
- "hs_note_body": "{{record.summary}}\n\nNext steps: {{record.nextSteps}}",
208
- "hs_timestamp": "$.now"
209
- }
210
- }
211
- }
212
- ]
213
- },
214
- {
215
- "id": "missed-call-task",
216
- "label": "Follow-up task for missed calls",
217
- "purpose": "write",
218
- "default": "off",
219
- "settings": {
220
- "owner": {
221
- "type": "option",
222
- "options": "hubspot.owner",
223
- "label": "Assign tasks to",
224
- "help": "Leave empty to use the contact owner."
225
- },
226
- "dueIn": {
227
- "type": "duration",
228
- "label": "Due in",
229
- "default": "4h"
230
- }
231
- },
232
- "trigger": {
233
- "type": "webhook",
234
- "module": "phone",
235
- "topic": "call.missed",
236
- "filter": "$.record.direction == 'incoming'"
237
- },
238
- "steps": [
239
- {
240
- "id": "contact",
241
- "use": "links.find",
242
- "with": {
243
- "sync": "contacts",
244
- "key": {
245
- "phone": "$.record.from"
246
- }
247
- }
248
- },
249
- {
250
- "use": "stop",
251
- "when": "$.steps.contact == null",
252
- "with": {
253
- "reason": "Caller is not a known contact"
254
- }
255
- },
256
- {
257
- "id": "full",
258
- "use": "hubspot.contact.get",
259
- "with": {
260
- "id": "$.steps.contact.hubspot",
261
- "properties": [
262
- "hubspot_owner_id",
263
- "firstname"
264
- ]
265
- }
266
- },
267
- {
268
- "use": "hubspot.task.create",
269
- "with": {
270
- "contactId": "$.steps.contact.hubspot",
271
- "properties": {
272
- "hs_task_subject": "Call back {{steps.full.properties.firstname | default: 'caller'}} (missed Phone call)",
273
- "hs_task_body": "Missed call from {{record.from}} at {{record.createdAt}}.",
274
- "hs_timestamp": "$.record.createdAt",
275
- "hubspot_owner_id": "{{settings.owner | default: steps.full.properties.hubspot_owner_id}}"
276
- }
277
- }
278
- }
279
- ]
280
- },
281
- {
282
- "id": "texts-timeline",
283
- "label": "Texts on the contact timeline",
284
- "purpose": "write",
285
- "default": "on",
286
- "trigger": {
287
- "type": "webhook",
288
- "module": "phone",
289
- "topic": "message.received"
290
- },
291
- "steps": [
292
- {
293
- "id": "contact",
294
- "use": "links.find",
295
- "with": {
296
- "sync": "contacts",
297
- "key": {
298
- "phone": "$.record.from"
299
- }
300
- }
301
- },
302
- {
303
- "use": "stop",
304
- "when": "$.steps.contact == null",
305
- "with": {
306
- "reason": "Sender is not a known contact"
307
- }
308
- },
309
- {
310
- "use": "hubspot.note.create",
311
- "with": {
312
- "contactId": "$.steps.contact.hubspot",
313
- "properties": {
314
- "hs_note_body": "Text from {{record.from}}: {{record.text}}",
315
- "hs_timestamp": "$.record.createdAt"
316
- }
317
- }
318
- }
319
- ]
320
- },
321
- {
322
- "id": "won-thank-you",
323
- "label": "Thank-you text on closed won",
324
- "purpose": "notify",
325
- "default": "off",
326
- "settings": {
327
- "message": {
328
- "type": "text",
329
- "label": "Message",
330
- "default": "Thanks for choosing us, {{vars.contact.properties.firstname}}! Text this number any time."
331
- }
332
- },
333
- "trigger": {
334
- "type": "webhook",
335
- "module": "hubspot",
336
- "topic": "deal.propertyChange",
337
- "filter": "$.record.propertyName == 'dealstage' && $.record.propertyValue == 'closedwon'"
338
- },
339
- "steps": [
340
- {
341
- "id": "contacts",
342
- "use": "hubspot.deal.contacts",
343
- "with": {
344
- "dealId": "$.record.objectId"
345
- }
346
- },
347
- {
348
- "use": "set",
349
- "with": {
350
- "contact": "$.steps.contacts[0]"
351
- }
352
- },
353
- {
354
- "use": "stop",
355
- "when": "!($.vars.contact.properties.phone exists)",
356
- "with": {
357
- "reason": "Deal has no contact with a phone number"
358
- }
359
- },
360
- {
361
- "id": "text",
362
- "use": "template",
363
- "with": {
364
- "text": "$.settings.message"
365
- }
366
- },
367
- {
368
- "use": "phone.message.send",
369
- "with": {
370
- "from": "$.install.fromNumber",
371
- "to": [
372
- "$.vars.contact.properties.phone"
373
- ],
374
- "content": "$.steps.text"
375
- }
376
- }
377
- ]
378
- },
379
- {
380
- "id": "stale-contacts",
381
- "label": "Flag contacts with no calls in 30 days",
382
- "purpose": "maintain",
383
- "default": "off",
384
- "trigger": {
385
- "type": "schedule",
386
- "cron": "0 6 * * *",
387
- "timezone": "America/New_York"
388
- },
389
- "steps": [
390
- {
391
- "id": "stale",
392
- "use": "hubspot.contact.search",
393
- "with": {
394
- "lastContactedBefore": "-30d",
395
- "limit": 100
396
- }
397
- },
398
- {
399
- "id": "each",
400
- "use": "foreach",
401
- "with": {
402
- "over": "$.steps.stale.results",
403
- "max": 100
404
- },
405
- "do": [
406
- {
407
- "use": "hubspot.contact.update",
408
- "with": {
409
- "id": "$.item.id",
410
- "properties": {
411
- "phone_last_call": "$.item.properties.notes_last_contacted"
412
- }
413
- }
414
- }
415
- ]
416
- }
417
- ]
418
- },
419
- {
420
- "id": "text-from-card",
421
- "label": "Text the contact from HubSpot",
422
- "purpose": "respond",
423
- "default": "on",
424
- "trigger": {
425
- "type": "userAction",
426
- "label": "Send text",
427
- "from": "phone-card"
428
- },
429
- "steps": [
430
- {
431
- "use": "phone.message.send",
432
- "with": {
433
- "from": "$.install.fromNumber",
434
- "to": [
435
- "$.record.properties.phone"
436
- ],
437
- "content": "$.event.input.message"
438
- }
439
- }
440
- ]
441
- }
442
- ],
443
- "queries": [
444
- {
445
- "id": "recent-activity",
446
- "description": "The last five calls and texts with this contact's number.",
447
- "steps": [
448
- {
449
- "id": "calls",
450
- "use": "phone.call.list",
451
- "with": {
452
- "participant": "$.record.properties.phone",
453
- "maxResults": 5
454
- }
455
- },
456
- {
457
- "id": "texts",
458
- "use": "phone.message.list",
459
- "with": {
460
- "participants": [
461
- "$.record.properties.phone"
462
- ],
463
- "maxResults": 5
464
- }
465
- }
466
- ],
467
- "returns": {
468
- "calls": "$.steps.calls",
469
- "texts": "$.steps.texts"
470
- }
471
- },
472
- {
473
- "id": "open-deals",
474
- "description": "Open HubSpot deals for the contact in the current Phone conversation.",
475
- "steps": [
476
- {
477
- "id": "contact",
478
- "use": "links.find",
479
- "with": {
480
- "sync": "contacts",
481
- "key": {
482
- "phone": "$.record.phoneNumber"
483
- }
484
- }
485
- },
486
- {
487
- "use": "stop",
488
- "when": "$.steps.contact == null",
489
- "with": {
490
- "reason": "Not linked"
491
- }
492
- },
493
- {
494
- "id": "deals",
495
- "use": "hubspot.deal.listForContact",
496
- "with": {
497
- "contactId": "$.steps.contact.hubspot",
498
- "open": true
499
- }
500
- }
501
- ],
502
- "returns": {
503
- "contactId": "$.steps.contact.hubspot",
504
- "deals": "$.steps.deals"
505
- }
506
- }
507
- ],
508
- "ui": [
509
- {
510
- "id": "phone-card",
511
- "label": "Phone activity",
512
- "host": "hubspot",
513
- "placement": "crm.record.sidebar",
514
- "objects": [
515
- "contact"
516
- ],
517
- "data": {
518
- "query": "recent-activity"
519
- },
520
- "view": {
521
- "component": "Stack",
522
- "children": [
523
- {
524
- "component": "Heading",
525
- "props": {
526
- "text": "Phone activity"
527
- }
528
- },
529
- {
530
- "component": "List",
531
- "props": {
532
- "items": "$.data.calls",
533
- "title": "{{item.direction}} call · {{item.duration | default: 0}}s",
534
- "meta": "{{item.createdAt | date}}"
535
- }
536
- },
537
- {
538
- "component": "List",
539
- "props": {
540
- "items": "$.data.texts",
541
- "title": "{{item.text | truncate: 60}}",
542
- "meta": "{{item.createdAt | date}}"
543
- }
544
- },
545
- {
546
- "component": "Empty",
547
- "when": "$.data.calls == null",
548
- "props": {
549
- "text": "No Phone activity with this number yet."
550
- }
551
- },
552
- {
553
- "component": "Button",
554
- "props": {
555
- "label": "Send text",
556
- "action": {
557
- "type": "userAction",
558
- "workflow": "text-from-card",
559
- "input": {
560
- "message": {
561
- "type": "text",
562
- "label": "Message"
563
- }
564
- }
565
- }
566
- }
567
- }
568
- ]
569
- }
570
- },
571
- {
572
- "id": "deals-panel",
573
- "label": "HubSpot deals",
574
- "host": "phone",
575
- "placement": "conversation.sidebar",
576
- "data": {
577
- "query": "open-deals"
578
- },
579
- "view": {
580
- "component": "Stack",
581
- "children": [
582
- {
583
- "component": "Heading",
584
- "props": {
585
- "text": "Open deals"
586
- }
587
- },
588
- {
589
- "component": "Table",
590
- "props": {
591
- "rows": "$.data.deals",
592
- "columns": [
593
- {
594
- "label": "Deal",
595
- "value": "{{row.properties.dealname}}"
596
- },
597
- {
598
- "label": "Amount",
599
- "value": "{{row.properties.amount}}"
600
- },
601
- {
602
- "label": "Stage",
603
- "value": "{{row.properties.dealstage}}"
604
- }
605
- ]
606
- }
607
- },
608
- {
609
- "component": "Button",
610
- "props": {
611
- "label": "Open in HubSpot",
612
- "action": {
613
- "type": "open_url",
614
- "url": "https://app.hubspot.com/contacts/{{install.portalId}}/record/0-1/{{data.contactId}}"
615
- }
616
- }
617
- }
618
- ]
619
- }
620
- }
621
- ],
622
- "templates": {
623
- "call-note": "Phone call with {{record.from}} · {{record.duration}}s ({{record.status}})"
624
- },
625
- "lifecycle": {
626
- "onInstall": [
627
- {
628
- "id": "hook",
629
- "use": "phone.webhook.create",
630
- "with": {
631
- "url": "$.install.webhookUrls.phone",
632
- "events": [
633
- "call.completed",
634
- "call.ringing",
635
- "call.summary.completed",
636
- "message.received",
637
- "contact.updated"
638
- ]
639
- }
640
- }
641
- ],
642
- "onUninstall": [
643
- {
644
- "use": "phone.webhook.delete",
645
- "with": {
646
- "id": "$.install.runtime.installed.hook.id"
647
- }
648
- }
649
- ]
650
- }
651
- }
652
- }