@elevasis/core 0.22.0 → 0.24.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 (244) hide show
  1. package/dist/index.d.ts +3214 -2501
  2. package/dist/index.js +3112 -1222
  3. package/dist/knowledge/index.d.ts +1108 -1264
  4. package/dist/knowledge/index.js +112 -9
  5. package/dist/organization-model/index.d.ts +3214 -2501
  6. package/dist/organization-model/index.js +3112 -1222
  7. package/dist/test-utils/index.d.ts +985 -1103
  8. package/dist/test-utils/index.js +2464 -1165
  9. package/package.json +5 -5
  10. package/src/README.md +14 -14
  11. package/src/__tests__/publish.test.ts +24 -24
  12. package/src/__tests__/template-core-compatibility.test.ts +9 -80
  13. package/src/_gen/__tests__/__snapshots__/contracts.md.snap +2389 -2121
  14. package/src/_gen/__tests__/scaffold-contracts.test.ts +30 -30
  15. package/src/auth/multi-tenancy/credentials/__tests__/encryption.test.ts +217 -217
  16. package/src/auth/multi-tenancy/credentials/server/encryption.ts +69 -69
  17. package/src/auth/multi-tenancy/credentials/server/kek-loader.ts +37 -37
  18. package/src/auth/multi-tenancy/index.ts +26 -26
  19. package/src/auth/multi-tenancy/invitations/api-schemas.ts +104 -104
  20. package/src/auth/multi-tenancy/memberships/api-schemas.ts +143 -143
  21. package/src/auth/multi-tenancy/memberships/index.ts +26 -26
  22. package/src/auth/multi-tenancy/memberships/membership.ts +130 -130
  23. package/src/auth/multi-tenancy/organizations/__tests__/api-schemas.test.ts +194 -194
  24. package/src/auth/multi-tenancy/organizations/api-schemas.ts +136 -136
  25. package/src/auth/multi-tenancy/permissions.test.ts +42 -42
  26. package/src/auth/multi-tenancy/permissions.ts +123 -123
  27. package/src/auth/multi-tenancy/role-management/api-schemas.ts +78 -78
  28. package/src/auth/multi-tenancy/role-management/index.ts +16 -16
  29. package/src/auth/multi-tenancy/theme-presets.ts +45 -45
  30. package/src/auth/multi-tenancy/types.ts +57 -57
  31. package/src/auth/multi-tenancy/users/api-schemas.ts +165 -165
  32. package/src/business/README.md +2 -2
  33. package/src/business/acquisition/activity-events.test.ts +250 -250
  34. package/src/business/acquisition/activity-events.ts +93 -93
  35. package/src/business/acquisition/api-schemas.test.ts +1883 -1843
  36. package/src/business/acquisition/api-schemas.ts +1493 -1500
  37. package/src/business/acquisition/build-templates.test.ts +240 -240
  38. package/src/business/acquisition/build-templates.ts +83 -41
  39. package/src/business/acquisition/crm-next-action.test.ts +262 -262
  40. package/src/business/acquisition/crm-next-action.ts +220 -220
  41. package/src/business/acquisition/crm-priority.test.ts +216 -216
  42. package/src/business/acquisition/crm-priority.ts +349 -349
  43. package/src/business/acquisition/crm-state-actions.test.ts +153 -151
  44. package/src/business/acquisition/deal-ownership.test.ts +351 -351
  45. package/src/business/acquisition/deal-ownership.ts +120 -120
  46. package/src/business/acquisition/derive-actions.test.ts +129 -104
  47. package/src/business/acquisition/derive-actions.ts +74 -84
  48. package/src/business/acquisition/index.ts +171 -170
  49. package/src/business/acquisition/ontology-validation.ts +309 -0
  50. package/src/business/acquisition/stateful.ts +30 -30
  51. package/src/business/acquisition/types.ts +396 -392
  52. package/src/business/clients/api-schemas.test.ts +115 -115
  53. package/src/business/clients/api-schemas.ts +158 -158
  54. package/src/business/clients/index.ts +1 -1
  55. package/src/business/crm/api-schemas.ts +40 -40
  56. package/src/business/crm/index.ts +1 -1
  57. package/src/business/deals/api-schemas.ts +87 -87
  58. package/src/business/deals/index.ts +1 -1
  59. package/src/business/index.ts +5 -5
  60. package/src/business/projects/types.ts +144 -144
  61. package/src/commands/queue/types/task.ts +15 -15
  62. package/src/execution/core/runner-types.ts +61 -61
  63. package/src/execution/core/sse-executions.ts +7 -7
  64. package/src/execution/engine/__tests__/fixtures/test-agents.ts +10 -10
  65. package/src/execution/engine/agent/core/__tests__/agent.test.ts +16 -16
  66. package/src/execution/engine/agent/core/__tests__/error-passthrough.test.ts +4 -4
  67. package/src/execution/engine/agent/core/types.ts +25 -25
  68. package/src/execution/engine/agent/index.ts +6 -6
  69. package/src/execution/engine/agent/reasoning/__tests__/request-builder.test.ts +24 -24
  70. package/src/execution/engine/index.ts +443 -443
  71. package/src/execution/engine/tools/integration/server/adapters/apify/__tests__/apify-run-actor.integration.test.ts +298 -298
  72. package/src/execution/engine/tools/integration/server/adapters/apify/apify-adapter.test.ts +55 -55
  73. package/src/execution/engine/tools/integration/server/adapters/apify/apify-adapter.ts +107 -107
  74. package/src/execution/engine/tools/integration/server/adapters/apollo/apollo-adapter.test.ts +48 -48
  75. package/src/execution/engine/tools/integration/server/adapters/apollo/apollo-adapter.ts +99 -99
  76. package/src/execution/engine/tools/integration/server/adapters/apollo/index.ts +1 -1
  77. package/src/execution/engine/tools/integration/server/adapters/attio/__tests__/attio-crud.integration.test.ts +363 -363
  78. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/get-record/index.test.ts +162 -162
  79. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-records/index.test.ts +316 -316
  80. package/src/execution/engine/tools/integration/server/adapters/clickup/clickup-adapter.test.ts +18 -18
  81. package/src/execution/engine/tools/integration/server/adapters/clickup/clickup-adapter.ts +194 -194
  82. package/src/execution/engine/tools/integration/server/adapters/clickup/index.ts +7 -7
  83. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-adapter.ts +204 -204
  84. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-tools.ts +105 -105
  85. package/src/execution/engine/tools/integration/server/adapters/google-calendar/google-calendar-adapter.ts +428 -428
  86. package/src/execution/engine/tools/integration/server/adapters/google-calendar/index.ts +2 -2
  87. package/src/execution/engine/tools/integration/server/adapters/google-sheets/__tests__/google-sheets.integration.test.ts +261 -261
  88. package/src/execution/engine/tools/integration/server/adapters/instantly/instantly-tools.ts +1474 -1474
  89. package/src/execution/engine/tools/integration/server/adapters/millionverifier/millionverifier-tools.ts +103 -103
  90. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/send-email/index.test.ts +88 -88
  91. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/send-email/index.ts +141 -141
  92. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/utils/types.ts +76 -76
  93. package/src/execution/engine/tools/integration/server/adapters/signature-api/signature-api-tools.ts +182 -182
  94. package/src/execution/engine/tools/integration/server/adapters/stripe/stripe-tools.ts +310 -310
  95. package/src/execution/engine/tools/integration/service.test.ts +239 -239
  96. package/src/execution/engine/tools/integration/service.ts +172 -172
  97. package/src/execution/engine/tools/integration/tool.ts +255 -255
  98. package/src/execution/engine/tools/lead-service-types.ts +1005 -1005
  99. package/src/execution/engine/tools/messages.ts +43 -43
  100. package/src/execution/engine/tools/platform/acquisition/company-tools.ts +7 -7
  101. package/src/execution/engine/tools/platform/acquisition/contact-tools.ts +6 -6
  102. package/src/execution/engine/tools/platform/acquisition/list-tools.ts +6 -6
  103. package/src/execution/engine/tools/platform/acquisition/types.ts +280 -280
  104. package/src/execution/engine/tools/platform/email/types.ts +97 -97
  105. package/src/execution/engine/tools/registry.ts +704 -704
  106. package/src/execution/engine/tools/tool-maps.ts +831 -831
  107. package/src/execution/engine/tools/types.ts +234 -234
  108. package/src/execution/engine/workflow/types.ts +202 -202
  109. package/src/execution/external/__tests__/api-schemas.test.ts +127 -127
  110. package/src/execution/external/api-schemas.ts +40 -40
  111. package/src/execution/external/index.ts +1 -1
  112. package/src/index.ts +18 -18
  113. package/src/integrations/credentials/__tests__/api-schemas.test.ts +420 -420
  114. package/src/integrations/credentials/api-schemas.ts +146 -146
  115. package/src/integrations/credentials/schemas.ts +200 -200
  116. package/src/integrations/oauth/__tests__/provider-registry.test.ts +7 -7
  117. package/src/integrations/oauth/provider-registry.ts +74 -74
  118. package/src/integrations/oauth/server/credentials.ts +43 -43
  119. package/src/integrations/webhook-endpoints/__tests__/api-schemas.test.ts +327 -327
  120. package/src/integrations/webhook-endpoints/api-schemas.ts +103 -103
  121. package/src/integrations/webhook-endpoints/types.ts +58 -58
  122. package/src/knowledge/README.md +33 -32
  123. package/src/knowledge/__tests__/queries.test.ts +633 -541
  124. package/src/knowledge/format.ts +100 -99
  125. package/src/knowledge/index.ts +5 -5
  126. package/src/knowledge/published.ts +5 -5
  127. package/src/knowledge/queries.ts +274 -222
  128. package/src/operations/activities/api-schemas.ts +80 -80
  129. package/src/operations/activities/types.ts +64 -64
  130. package/src/organization-model/README.md +149 -109
  131. package/src/organization-model/__tests__/content-kinds-registry.test.ts +210 -0
  132. package/src/organization-model/__tests__/defaults.test.ts +168 -194
  133. package/src/organization-model/__tests__/domains/actions.test.ts +78 -0
  134. package/src/organization-model/__tests__/domains/customers.test.ts +48 -44
  135. package/src/organization-model/__tests__/domains/entities.test.ts +56 -0
  136. package/src/organization-model/__tests__/domains/goals.test.ts +110 -96
  137. package/src/organization-model/__tests__/domains/identity.test.ts +4 -3
  138. package/src/organization-model/__tests__/domains/navigation.test.ts +222 -166
  139. package/src/organization-model/__tests__/domains/offerings.test.ts +83 -88
  140. package/src/organization-model/__tests__/domains/policies.test.ts +323 -0
  141. package/src/organization-model/__tests__/domains/resource-mappings.test.ts +30 -30
  142. package/src/organization-model/__tests__/domains/resources.test.ts +396 -175
  143. package/src/organization-model/__tests__/domains/roles.test.ts +463 -402
  144. package/src/organization-model/__tests__/domains/statuses.test.ts +13 -10
  145. package/src/organization-model/__tests__/domains/systems.test.ts +209 -193
  146. package/src/organization-model/__tests__/flatten-additive-merge.test.ts +362 -0
  147. package/src/organization-model/__tests__/foundation.test.ts +47 -75
  148. package/src/organization-model/__tests__/get-resources-for-system.test.ts +144 -0
  149. package/src/organization-model/__tests__/graph.test.ts +1336 -149
  150. package/src/organization-model/__tests__/icons.test.ts +10 -1
  151. package/src/organization-model/__tests__/knowledge.test.ts +418 -61
  152. package/src/organization-model/__tests__/lookup-helpers.test.ts +438 -0
  153. package/src/organization-model/__tests__/migration-helpers.test.ts +591 -0
  154. package/src/organization-model/__tests__/prospecting-ssot.test.ts +103 -94
  155. package/src/organization-model/__tests__/recursive-system-schema.test.ts +549 -0
  156. package/src/organization-model/__tests__/resolve.test.ts +303 -42
  157. package/src/organization-model/__tests__/schema.test.ts +863 -153
  158. package/src/organization-model/__tests__/surface-projection.test.ts +284 -174
  159. package/src/organization-model/catalogs/lead-gen.ts +144 -0
  160. package/src/organization-model/content-kinds/config.ts +36 -0
  161. package/src/organization-model/content-kinds/index.ts +78 -0
  162. package/src/organization-model/content-kinds/pipeline.ts +68 -0
  163. package/src/organization-model/content-kinds/registry.ts +44 -0
  164. package/src/organization-model/content-kinds/status.ts +71 -0
  165. package/src/organization-model/content-kinds/template.ts +83 -0
  166. package/src/organization-model/content-kinds/types.ts +117 -0
  167. package/src/organization-model/contracts.ts +27 -17
  168. package/src/organization-model/defaults.ts +489 -107
  169. package/src/organization-model/domains/actions.ts +333 -0
  170. package/src/organization-model/domains/customers.ts +10 -7
  171. package/src/organization-model/domains/entities.ts +144 -0
  172. package/src/organization-model/domains/goals.ts +9 -6
  173. package/src/organization-model/domains/knowledge.ts +128 -54
  174. package/src/organization-model/domains/navigation.ts +139 -416
  175. package/src/organization-model/domains/offerings.ts +15 -10
  176. package/src/organization-model/domains/policies.ts +102 -0
  177. package/src/organization-model/domains/projects.ts +6 -40
  178. package/src/organization-model/domains/prospecting.ts +395 -514
  179. package/src/organization-model/domains/resources.ts +173 -81
  180. package/src/organization-model/domains/roles.ts +96 -93
  181. package/src/organization-model/domains/sales.test.ts +218 -218
  182. package/src/organization-model/domains/sales.ts +380 -589
  183. package/src/organization-model/domains/shared.ts +8 -8
  184. package/src/organization-model/domains/statuses.ts +298 -89
  185. package/src/organization-model/domains/systems.ts +240 -38
  186. package/src/organization-model/foundation.ts +35 -48
  187. package/src/organization-model/graph/build.ts +1035 -279
  188. package/src/organization-model/graph/index.ts +4 -4
  189. package/src/organization-model/graph/link.ts +10 -10
  190. package/src/organization-model/graph/schema.ts +77 -56
  191. package/src/organization-model/graph/types.ts +75 -56
  192. package/src/organization-model/helpers.ts +312 -59
  193. package/src/organization-model/icons.ts +78 -66
  194. package/src/organization-model/index.ts +129 -16
  195. package/src/organization-model/migration-helpers.ts +252 -0
  196. package/src/organization-model/ontology.ts +661 -0
  197. package/src/organization-model/organization-graph.mdx +110 -89
  198. package/src/organization-model/organization-model.mdx +226 -171
  199. package/src/organization-model/published.ts +295 -139
  200. package/src/organization-model/resolve.ts +139 -21
  201. package/src/organization-model/schema.ts +841 -301
  202. package/src/organization-model/surface-projection.ts +212 -218
  203. package/src/organization-model/types.ts +181 -90
  204. package/src/platform/api/types.ts +38 -38
  205. package/src/platform/constants/versions.ts +3 -3
  206. package/src/platform/index.ts +23 -23
  207. package/src/platform/registry/__tests__/command-view.test.ts +5 -7
  208. package/src/platform/registry/__tests__/resource-link.test.ts +35 -30
  209. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +17 -32
  210. package/src/platform/registry/__tests__/resource-registry.nested-systems.test.ts +245 -0
  211. package/src/platform/registry/__tests__/resource-registry.test.ts +2053 -2051
  212. package/src/platform/registry/__tests__/validation.test.ts +1347 -1343
  213. package/src/platform/registry/command-view.ts +10 -10
  214. package/src/platform/registry/index.ts +103 -103
  215. package/src/platform/registry/resource-link.ts +32 -32
  216. package/src/platform/registry/resource-registry.ts +890 -878
  217. package/src/platform/registry/serialization.ts +295 -295
  218. package/src/platform/registry/serialized-types.ts +166 -166
  219. package/src/platform/registry/stats-types.ts +68 -68
  220. package/src/platform/registry/types.ts +425 -425
  221. package/src/platform/registry/validation.ts +745 -743
  222. package/src/platform/utils/__tests__/validation.test.ts +1084 -1084
  223. package/src/platform/utils/validation.ts +425 -425
  224. package/src/projects/api-schemas.test.ts +39 -39
  225. package/src/projects/api-schemas.ts +291 -291
  226. package/src/reference/_generated/contracts.md +2389 -2121
  227. package/src/reference/glossary.md +76 -76
  228. package/src/scaffold-registry/__tests__/index.test.ts +206 -206
  229. package/src/scaffold-registry/__tests__/schema.test.ts +166 -166
  230. package/src/scaffold-registry/index.ts +392 -392
  231. package/src/scaffold-registry/schema.ts +243 -243
  232. package/src/server.ts +289 -289
  233. package/src/supabase/database.types.ts +3153 -3093
  234. package/src/test-utils/README.md +37 -37
  235. package/src/test-utils/entities.ts +108 -108
  236. package/src/test-utils/fixtures/memberships.ts +82 -82
  237. package/src/test-utils/index.ts +12 -12
  238. package/src/test-utils/organization-model.ts +65 -65
  239. package/src/test-utils/published.ts +6 -6
  240. package/src/test-utils/rls/RLSTestContext.ts +588 -588
  241. package/src/test-utils/test-utils.test.ts +44 -49
  242. package/src/organization-model/__tests__/domains/operations.test.ts +0 -203
  243. package/src/organization-model/domains/features.ts +0 -31
  244. package/src/organization-model/domains/operations.ts +0 -85
@@ -1,240 +1,240 @@
1
- import { describe, expect, it } from 'vitest'
2
- import {
3
- DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID,
4
- PROSPECTING_BUILD_TEMPLATE_OPTIONS,
5
- createBuildPlanSnapshotFromTemplateId,
6
- isProspectingBuildTemplateId
7
- } from './build-templates'
8
-
9
- // ---------------------------------------------------------------------------
10
- // isProspectingBuildTemplateId
11
- // ---------------------------------------------------------------------------
12
-
13
- describe('isProspectingBuildTemplateId', () => {
14
- it('returns true for every id in PROSPECTING_BUILD_TEMPLATE_OPTIONS', () => {
15
- for (const option of PROSPECTING_BUILD_TEMPLATE_OPTIONS) {
16
- expect(isProspectingBuildTemplateId(option.id)).toBe(true)
17
- }
18
- })
19
-
20
- it('returns true for the known "local-services" template id', () => {
21
- expect(isProspectingBuildTemplateId('local-services')).toBe(true)
22
- })
23
-
24
- it('returns true for the known "dtc-subscription-apollo-clickup" template id', () => {
25
- expect(isProspectingBuildTemplateId('dtc-subscription-apollo-clickup')).toBe(true)
26
- })
27
-
28
- it('returns false for an unknown string', () => {
29
- expect(isProspectingBuildTemplateId('not-a-template')).toBe(false)
30
- })
31
-
32
- it('returns false for an empty string', () => {
33
- expect(isProspectingBuildTemplateId('')).toBe(false)
34
- })
35
-
36
- it('returns false for a partial id match', () => {
37
- expect(isProspectingBuildTemplateId('local')).toBe(false)
38
- expect(isProspectingBuildTemplateId('dtc-subscription')).toBe(false)
39
- })
40
-
41
- it('returns false for a whitespace-padded id', () => {
42
- expect(isProspectingBuildTemplateId(' local-services ')).toBe(false)
43
- })
44
-
45
- it('verifies PROSPECTING_BUILD_TEMPLATE_OPTIONS contains at least two entries', () => {
46
- expect(PROSPECTING_BUILD_TEMPLATE_OPTIONS.length).toBeGreaterThanOrEqual(2)
47
- })
48
-
49
- it('verifies DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID is itself a valid template id', () => {
50
- expect(isProspectingBuildTemplateId(DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID)).toBe(true)
51
- })
52
- })
53
-
54
- // ---------------------------------------------------------------------------
55
- // createBuildPlanSnapshotFromTemplateId — unknown id
56
- // ---------------------------------------------------------------------------
57
-
58
- describe('createBuildPlanSnapshotFromTemplateId — unknown id', () => {
59
- it('returns null for an unknown template id', () => {
60
- expect(createBuildPlanSnapshotFromTemplateId('not-a-template')).toBeNull()
61
- })
62
-
63
- it('returns null for an empty string', () => {
64
- expect(createBuildPlanSnapshotFromTemplateId('')).toBeNull()
65
- })
66
- })
67
-
68
- // ---------------------------------------------------------------------------
69
- // createBuildPlanSnapshotFromTemplateId — "local-services"
70
- // ---------------------------------------------------------------------------
71
-
72
- describe('createBuildPlanSnapshotFromTemplateId — "local-services"', () => {
73
- const snapshot = createBuildPlanSnapshotFromTemplateId('local-services')
74
-
75
- it('returns a non-null snapshot', () => {
76
- expect(snapshot).not.toBeNull()
77
- })
78
-
79
- it('preserves the template id in the snapshot', () => {
80
- expect(snapshot?.templateId).toBe('local-services')
81
- })
82
-
83
- it('includes a non-empty templateLabel', () => {
84
- expect(snapshot?.templateLabel).toBeTruthy()
85
- })
86
-
87
- it('produces a steps array with length matching the catalog (7 steps)', () => {
88
- expect(snapshot?.steps).toHaveLength(7)
89
- })
90
-
91
- it('every step has required fields: id, label, primaryEntity, outputs, stageKey, dependencyMode, capabilityKey', () => {
92
- for (const step of snapshot?.steps ?? []) {
93
- expect(step.id).toBeTruthy()
94
- expect(step.label).toBeTruthy()
95
- expect(['company', 'contact']).toContain(step.primaryEntity)
96
- expect(step.outputs.length).toBeGreaterThanOrEqual(1)
97
- expect(step.stageKey).toBeTruthy()
98
- expect(step.dependencyMode).toBe('per-record-eligibility')
99
- expect(step.capabilityKey).toBeTruthy()
100
- }
101
- })
102
-
103
- it('every step has positive defaultBatchSize and maxBatchSize', () => {
104
- for (const step of snapshot?.steps ?? []) {
105
- expect(step.defaultBatchSize).toBeGreaterThan(0)
106
- expect(step.maxBatchSize).toBeGreaterThanOrEqual(step.defaultBatchSize)
107
- }
108
- })
109
-
110
- it('steps with declared dependsOn in the catalog have dependsOn in the snapshot', () => {
111
- const withDeps = snapshot?.steps.filter((step) => step.dependsOn !== undefined) ?? []
112
- expect(withDeps.length).toBeGreaterThan(0)
113
- for (const step of withDeps) {
114
- expect(Array.isArray(step.dependsOn)).toBe(true)
115
- expect((step.dependsOn ?? []).length).toBeGreaterThan(0)
116
- }
117
- })
118
-
119
- it('the first step (source-companies) has no dependsOn', () => {
120
- const first = snapshot?.steps[0]
121
- expect(first?.id).toBe('source-companies')
122
- expect(first?.dependsOn).toBeUndefined()
123
- })
124
-
125
- it('outputs arrays are copies (mutation does not affect subsequent calls)', () => {
126
- const snapshotA = createBuildPlanSnapshotFromTemplateId('local-services')
127
- const snapshotB = createBuildPlanSnapshotFromTemplateId('local-services')
128
- snapshotA?.steps[0]?.outputs.push('export' as never)
129
- expect(snapshotB?.steps[0]?.outputs).not.toContain('export')
130
- })
131
- })
132
-
133
- // ---------------------------------------------------------------------------
134
- // createBuildPlanSnapshotFromTemplateId — "dtc-subscription-apollo-clickup"
135
- // ---------------------------------------------------------------------------
136
-
137
- describe('createBuildPlanSnapshotFromTemplateId — "dtc-subscription-apollo-clickup"', () => {
138
- const snapshot = createBuildPlanSnapshotFromTemplateId('dtc-subscription-apollo-clickup')
139
-
140
- it('returns a non-null snapshot', () => {
141
- expect(snapshot).not.toBeNull()
142
- })
143
-
144
- it('preserves the template id in the snapshot', () => {
145
- expect(snapshot?.templateId).toBe('dtc-subscription-apollo-clickup')
146
- })
147
-
148
- it('produces a steps array with length matching the catalog (6 steps)', () => {
149
- expect(snapshot?.steps).toHaveLength(6)
150
- })
151
-
152
- it('every step has required fields: id, label, primaryEntity, outputs, stageKey, dependencyMode, capabilityKey', () => {
153
- for (const step of snapshot?.steps ?? []) {
154
- expect(step.id).toBeTruthy()
155
- expect(step.label).toBeTruthy()
156
- expect(['company', 'contact']).toContain(step.primaryEntity)
157
- expect(step.outputs.length).toBeGreaterThanOrEqual(1)
158
- expect(step.stageKey).toBeTruthy()
159
- expect(step.dependencyMode).toBe('per-record-eligibility')
160
- expect(step.capabilityKey).toBeTruthy()
161
- }
162
- })
163
-
164
- it('every step has positive defaultBatchSize and maxBatchSize', () => {
165
- for (const step of snapshot?.steps ?? []) {
166
- expect(step.defaultBatchSize).toBeGreaterThan(0)
167
- expect(step.maxBatchSize).toBeGreaterThanOrEqual(step.defaultBatchSize)
168
- }
169
- })
170
-
171
- it('the first step (import-apollo-search) has no dependsOn', () => {
172
- const first = snapshot?.steps[0]
173
- expect(first?.id).toBe('import-apollo-search')
174
- expect(first?.dependsOn).toBeUndefined()
175
- })
176
-
177
- it('the first step outputs both company and contact', () => {
178
- const first = snapshot?.steps[0]
179
- expect(first?.outputs).toContain('company')
180
- expect(first?.outputs).toContain('contact')
181
- })
182
-
183
- it('preserves Apollo credential requirements for source import and decision-maker enrichment', () => {
184
- const importApolloSearch = snapshot?.steps.find((step) => step.id === 'import-apollo-search')
185
- const enrichDecisionMakers = snapshot?.steps.find((step) => step.id === 'enrich-decision-makers')
186
-
187
- const expectedRequirement = {
188
- key: 'apollo',
189
- provider: 'apollo',
190
- credentialType: 'api-key-secret',
191
- label: 'Apollo API key',
192
- required: true,
193
- selectionMode: 'single',
194
- inputPath: 'credential'
195
- }
196
-
197
- expect(importApolloSearch?.credentialRequirements).toEqual([expectedRequirement])
198
- expect(enrichDecisionMakers?.credentialRequirements).toEqual([expectedRequirement])
199
- })
200
-
201
- it('the final step (review-and-export) outputs export', () => {
202
- const last = snapshot?.steps[snapshot.steps.length - 1]
203
- expect(last?.id).toBe('review-and-export')
204
- expect(last?.outputs).toContain('export')
205
- })
206
-
207
- it('preserves contact records metadata for the company-owned decision-maker step', () => {
208
- const decisionMakers = snapshot?.steps.find((step) => step.id === 'enrich-decision-makers')
209
- expect(decisionMakers).toMatchObject({
210
- primaryEntity: 'company',
211
- recordEntity: 'contact',
212
- stageKey: 'decision-makers-enriched'
213
- })
214
- expect(decisionMakers?.recordColumns?.contact?.length).toBeGreaterThan(0)
215
- })
216
-
217
- it('steps with descriptions in the catalog include description in the snapshot', () => {
218
- const withDesc = snapshot?.steps.filter((step) => step.description !== undefined) ?? []
219
- expect(withDesc.length).toBeGreaterThan(0)
220
- for (const step of withDesc) {
221
- expect(typeof step.description).toBe('string')
222
- expect(step.description!.length).toBeGreaterThan(0)
223
- }
224
- })
225
- })
226
-
227
- // ---------------------------------------------------------------------------
228
- // Snapshot shape contract — applies to every valid template id
229
- // ---------------------------------------------------------------------------
230
-
231
- describe('createBuildPlanSnapshotFromTemplateId — shape contract for all templates', () => {
232
- it('returns a snapshot for every id that isProspectingBuildTemplateId reports valid', () => {
233
- for (const option of PROSPECTING_BUILD_TEMPLATE_OPTIONS) {
234
- const snapshot = createBuildPlanSnapshotFromTemplateId(option.id)
235
- expect(snapshot).not.toBeNull()
236
- expect(snapshot?.templateId).toBe(option.id)
237
- expect(snapshot?.steps.length).toBeGreaterThan(0)
238
- }
239
- })
240
- })
1
+ import { describe, expect, it } from 'vitest'
2
+ import {
3
+ DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID,
4
+ PROSPECTING_BUILD_TEMPLATE_OPTIONS,
5
+ createBuildPlanSnapshotFromTemplateId,
6
+ isProspectingBuildTemplateId
7
+ } from './build-templates'
8
+
9
+ // ---------------------------------------------------------------------------
10
+ // isProspectingBuildTemplateId
11
+ // ---------------------------------------------------------------------------
12
+
13
+ describe('isProspectingBuildTemplateId', () => {
14
+ it('returns true for every id in PROSPECTING_BUILD_TEMPLATE_OPTIONS', () => {
15
+ for (const option of PROSPECTING_BUILD_TEMPLATE_OPTIONS) {
16
+ expect(isProspectingBuildTemplateId(option.id)).toBe(true)
17
+ }
18
+ })
19
+
20
+ it('returns true for the known "local-services" template id', () => {
21
+ expect(isProspectingBuildTemplateId('local-services')).toBe(true)
22
+ })
23
+
24
+ it('returns true for the known "dtc-subscription-apollo-clickup" template id', () => {
25
+ expect(isProspectingBuildTemplateId('dtc-subscription-apollo-clickup')).toBe(true)
26
+ })
27
+
28
+ it('returns false for an unknown string', () => {
29
+ expect(isProspectingBuildTemplateId('not-a-template')).toBe(false)
30
+ })
31
+
32
+ it('returns false for an empty string', () => {
33
+ expect(isProspectingBuildTemplateId('')).toBe(false)
34
+ })
35
+
36
+ it('returns false for a partial id match', () => {
37
+ expect(isProspectingBuildTemplateId('local')).toBe(false)
38
+ expect(isProspectingBuildTemplateId('dtc-subscription')).toBe(false)
39
+ })
40
+
41
+ it('returns false for a whitespace-padded id', () => {
42
+ expect(isProspectingBuildTemplateId(' local-services ')).toBe(false)
43
+ })
44
+
45
+ it('verifies PROSPECTING_BUILD_TEMPLATE_OPTIONS contains at least two entries', () => {
46
+ expect(PROSPECTING_BUILD_TEMPLATE_OPTIONS.length).toBeGreaterThanOrEqual(2)
47
+ })
48
+
49
+ it('verifies DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID is itself a valid template id', () => {
50
+ expect(isProspectingBuildTemplateId(DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID)).toBe(true)
51
+ })
52
+ })
53
+
54
+ // ---------------------------------------------------------------------------
55
+ // createBuildPlanSnapshotFromTemplateId — unknown id
56
+ // ---------------------------------------------------------------------------
57
+
58
+ describe('createBuildPlanSnapshotFromTemplateId — unknown id', () => {
59
+ it('returns null for an unknown template id', () => {
60
+ expect(createBuildPlanSnapshotFromTemplateId('not-a-template')).toBeNull()
61
+ })
62
+
63
+ it('returns null for an empty string', () => {
64
+ expect(createBuildPlanSnapshotFromTemplateId('')).toBeNull()
65
+ })
66
+ })
67
+
68
+ // ---------------------------------------------------------------------------
69
+ // createBuildPlanSnapshotFromTemplateId — "local-services"
70
+ // ---------------------------------------------------------------------------
71
+
72
+ describe('createBuildPlanSnapshotFromTemplateId — "local-services"', () => {
73
+ const snapshot = createBuildPlanSnapshotFromTemplateId('local-services')
74
+
75
+ it('returns a non-null snapshot', () => {
76
+ expect(snapshot).not.toBeNull()
77
+ })
78
+
79
+ it('preserves the template id in the snapshot', () => {
80
+ expect(snapshot?.templateId).toBe('local-services')
81
+ })
82
+
83
+ it('includes a non-empty templateLabel', () => {
84
+ expect(snapshot?.templateLabel).toBeTruthy()
85
+ })
86
+
87
+ it('produces a steps array with length matching the catalog (7 steps)', () => {
88
+ expect(snapshot?.steps).toHaveLength(7)
89
+ })
90
+
91
+ it('every step has required fields: id, label, primaryEntity, outputs, stageKey, dependencyMode, actionKey', () => {
92
+ for (const step of snapshot?.steps ?? []) {
93
+ expect(step.id).toBeTruthy()
94
+ expect(step.label).toBeTruthy()
95
+ expect(['company', 'contact']).toContain(step.primaryEntity)
96
+ expect(step.outputs.length).toBeGreaterThanOrEqual(1)
97
+ expect(step.stageKey).toBeTruthy()
98
+ expect(step.dependencyMode).toBe('per-record-eligibility')
99
+ expect(step.actionKey).toBeTruthy()
100
+ }
101
+ })
102
+
103
+ it('every step has positive defaultBatchSize and maxBatchSize', () => {
104
+ for (const step of snapshot?.steps ?? []) {
105
+ expect(step.defaultBatchSize).toBeGreaterThan(0)
106
+ expect(step.maxBatchSize).toBeGreaterThanOrEqual(step.defaultBatchSize)
107
+ }
108
+ })
109
+
110
+ it('steps with declared dependsOn in the catalog have dependsOn in the snapshot', () => {
111
+ const withDeps = snapshot?.steps.filter((step) => step.dependsOn !== undefined) ?? []
112
+ expect(withDeps.length).toBeGreaterThan(0)
113
+ for (const step of withDeps) {
114
+ expect(Array.isArray(step.dependsOn)).toBe(true)
115
+ expect((step.dependsOn ?? []).length).toBeGreaterThan(0)
116
+ }
117
+ })
118
+
119
+ it('the first step (source-companies) has no dependsOn', () => {
120
+ const first = snapshot?.steps[0]
121
+ expect(first?.id).toBe('source-companies')
122
+ expect(first?.dependsOn).toBeUndefined()
123
+ })
124
+
125
+ it('outputs arrays are copies (mutation does not affect subsequent calls)', () => {
126
+ const snapshotA = createBuildPlanSnapshotFromTemplateId('local-services')
127
+ const snapshotB = createBuildPlanSnapshotFromTemplateId('local-services')
128
+ snapshotA?.steps[0]?.outputs.push('export' as never)
129
+ expect(snapshotB?.steps[0]?.outputs).not.toContain('export')
130
+ })
131
+ })
132
+
133
+ // ---------------------------------------------------------------------------
134
+ // createBuildPlanSnapshotFromTemplateId — "dtc-subscription-apollo-clickup"
135
+ // ---------------------------------------------------------------------------
136
+
137
+ describe('createBuildPlanSnapshotFromTemplateId — "dtc-subscription-apollo-clickup"', () => {
138
+ const snapshot = createBuildPlanSnapshotFromTemplateId('dtc-subscription-apollo-clickup')
139
+
140
+ it('returns a non-null snapshot', () => {
141
+ expect(snapshot).not.toBeNull()
142
+ })
143
+
144
+ it('preserves the template id in the snapshot', () => {
145
+ expect(snapshot?.templateId).toBe('dtc-subscription-apollo-clickup')
146
+ })
147
+
148
+ it('produces a steps array with length matching the catalog (6 steps)', () => {
149
+ expect(snapshot?.steps).toHaveLength(6)
150
+ })
151
+
152
+ it('every step has required fields: id, label, primaryEntity, outputs, stageKey, dependencyMode, actionKey', () => {
153
+ for (const step of snapshot?.steps ?? []) {
154
+ expect(step.id).toBeTruthy()
155
+ expect(step.label).toBeTruthy()
156
+ expect(['company', 'contact']).toContain(step.primaryEntity)
157
+ expect(step.outputs.length).toBeGreaterThanOrEqual(1)
158
+ expect(step.stageKey).toBeTruthy()
159
+ expect(step.dependencyMode).toBe('per-record-eligibility')
160
+ expect(step.actionKey).toBeTruthy()
161
+ }
162
+ })
163
+
164
+ it('every step has positive defaultBatchSize and maxBatchSize', () => {
165
+ for (const step of snapshot?.steps ?? []) {
166
+ expect(step.defaultBatchSize).toBeGreaterThan(0)
167
+ expect(step.maxBatchSize).toBeGreaterThanOrEqual(step.defaultBatchSize)
168
+ }
169
+ })
170
+
171
+ it('the first step (import-apollo-search) has no dependsOn', () => {
172
+ const first = snapshot?.steps[0]
173
+ expect(first?.id).toBe('import-apollo-search')
174
+ expect(first?.dependsOn).toBeUndefined()
175
+ })
176
+
177
+ it('the first step outputs both company and contact', () => {
178
+ const first = snapshot?.steps[0]
179
+ expect(first?.outputs).toContain('company')
180
+ expect(first?.outputs).toContain('contact')
181
+ })
182
+
183
+ it('preserves Apollo credential requirements for source import and decision-maker enrichment', () => {
184
+ const importApolloSearch = snapshot?.steps.find((step) => step.id === 'import-apollo-search')
185
+ const enrichDecisionMakers = snapshot?.steps.find((step) => step.id === 'enrich-decision-makers')
186
+
187
+ const expectedRequirement = {
188
+ key: 'apollo',
189
+ provider: 'apollo',
190
+ credentialType: 'api-key-secret',
191
+ label: 'Apollo API key',
192
+ required: true,
193
+ selectionMode: 'single',
194
+ inputPath: 'credential'
195
+ }
196
+
197
+ expect(importApolloSearch?.credentialRequirements).toEqual([expectedRequirement])
198
+ expect(enrichDecisionMakers?.credentialRequirements).toEqual([expectedRequirement])
199
+ })
200
+
201
+ it('the final step (review-and-export) outputs export', () => {
202
+ const last = snapshot?.steps[snapshot.steps.length - 1]
203
+ expect(last?.id).toBe('review-and-export')
204
+ expect(last?.outputs).toContain('export')
205
+ })
206
+
207
+ it('preserves contact records metadata for the company-owned decision-maker step', () => {
208
+ const decisionMakers = snapshot?.steps.find((step) => step.id === 'enrich-decision-makers')
209
+ expect(decisionMakers).toMatchObject({
210
+ primaryEntity: 'company',
211
+ recordEntity: 'contact',
212
+ stageKey: 'decision-makers-enriched'
213
+ })
214
+ expect(decisionMakers?.recordColumns?.contact?.length).toBeGreaterThan(0)
215
+ })
216
+
217
+ it('steps with descriptions in the catalog include description in the snapshot', () => {
218
+ const withDesc = snapshot?.steps.filter((step) => step.description !== undefined) ?? []
219
+ expect(withDesc.length).toBeGreaterThan(0)
220
+ for (const step of withDesc) {
221
+ expect(typeof step.description).toBe('string')
222
+ expect(step.description!.length).toBeGreaterThan(0)
223
+ }
224
+ })
225
+ })
226
+
227
+ // ---------------------------------------------------------------------------
228
+ // Snapshot shape contract — applies to every valid template id
229
+ // ---------------------------------------------------------------------------
230
+
231
+ describe('createBuildPlanSnapshotFromTemplateId — shape contract for all templates', () => {
232
+ it('returns a snapshot for every id that isProspectingBuildTemplateId reports valid', () => {
233
+ for (const option of PROSPECTING_BUILD_TEMPLATE_OPTIONS) {
234
+ const snapshot = createBuildPlanSnapshotFromTemplateId(option.id)
235
+ expect(snapshot).not.toBeNull()
236
+ expect(snapshot?.templateId).toBe(option.id)
237
+ expect(snapshot?.steps.length).toBeGreaterThan(0)
238
+ }
239
+ })
240
+ })
@@ -1,56 +1,98 @@
1
- import { DEFAULT_ORGANIZATION_MODEL_PROSPECTING } from '../../organization-model/domains/prospecting'
1
+ // Phase 4: DEFAULT_ORGANIZATION_MODEL_PROSPECTING was deleted (compound domain removed per D8).
2
+ // Build-template definitions are now sourced inline from PROSPECTING_STEPS, which retains
3
+ // the step catalog. The template catalog (id, label, description, steps[]) is declared here
4
+ // as a local constant — Wave 2 will author these as system.content entries on the canonical OM.
5
+ import {
6
+ PROSPECTING_STEPS,
7
+ type CredentialRequirement,
8
+ type ListBuilderStep,
9
+ type RecordColumnConfig
10
+ } from '../../organization-model/domains/prospecting'
2
11
  import type { BuildPlanSnapshot, BuildPlanSnapshotStep } from './types'
3
12
 
4
- export const PROSPECTING_BUILD_TEMPLATE_OPTIONS = DEFAULT_ORGANIZATION_MODEL_PROSPECTING.buildTemplates.map(
5
- ({ id, label, description }) => ({
6
- id,
7
- label,
8
- description
9
- })
10
- )
13
+ interface BuildTemplateCatalogEntry {
14
+ id: string
15
+ label: string
16
+ description?: string
17
+ steps: ListBuilderStep[]
18
+ }
19
+
20
+ // Template catalog — mirrors the data that lived in DEFAULT_ORGANIZATION_MODEL_PROSPECTING.buildTemplates.
21
+ // Wave 2 canonical OM will author these as (kind:'schema', type:'template') content nodes.
22
+ const BUILD_TEMPLATE_CATALOG: BuildTemplateCatalogEntry[] = [
23
+ {
24
+ id: 'local-services',
25
+ label: 'Local Services',
26
+ description: 'Source, analyze, qualify, and personalize local service businesses for outreach.',
27
+ steps: Object.values(PROSPECTING_STEPS.localServices)
28
+ },
29
+ {
30
+ id: 'dtc-subscription-apollo-clickup',
31
+ label: 'DTC Subscription (Apollo + ClickUp)',
32
+ description:
33
+ 'Import DTC brand leads from Apollo, crawl their websites, score fit, enrich contacts, and export via ClickUp.',
34
+ steps: Object.values(PROSPECTING_STEPS.dtcApolloClickup)
35
+ }
36
+ ]
37
+
38
+ export const DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID = 'local-services'
11
39
 
12
- export const DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID = DEFAULT_ORGANIZATION_MODEL_PROSPECTING.defaultBuildTemplateId
40
+ export const PROSPECTING_BUILD_TEMPLATE_OPTIONS = BUILD_TEMPLATE_CATALOG.map(({ id, label, description }) => ({
41
+ id,
42
+ label,
43
+ description
44
+ }))
13
45
 
14
46
  export function isProspectingBuildTemplateId(value: string): boolean {
15
47
  return PROSPECTING_BUILD_TEMPLATE_OPTIONS.some((template) => template.id === value)
16
48
  }
17
49
 
18
50
  export function createBuildPlanSnapshotFromTemplateId(templateId: string): BuildPlanSnapshot | null {
19
- const template = DEFAULT_ORGANIZATION_MODEL_PROSPECTING.buildTemplates.find((item) => item.id === templateId)
51
+ const template = BUILD_TEMPLATE_CATALOG.find((item: BuildTemplateCatalogEntry) => item.id === templateId)
20
52
  if (!template) return null
21
53
 
22
54
  return {
23
55
  templateId: template.id,
24
56
  templateLabel: template.label,
25
- steps: template.steps.map((step): BuildPlanSnapshotStep => {
26
- const snapshotStep: BuildPlanSnapshotStep = {
27
- id: step.id,
28
- label: step.label,
29
- primaryEntity: step.primaryEntity,
30
- outputs: [...step.outputs],
31
- stageKey: step.stageKey,
32
- recordsStageKey: step.recordsStageKey ?? step.stageKey,
33
- recordSourceStageKey: step.recordSourceStageKey ?? step.recordsStageKey ?? step.stageKey,
34
- dependencyMode: step.dependencyMode,
35
- capabilityKey: step.capabilityKey,
36
- defaultBatchSize: step.defaultBatchSize,
37
- maxBatchSize: step.maxBatchSize
38
- }
39
-
40
- if (step.description) snapshotStep.description = step.description
41
- if (step.recordEntity) snapshotStep.recordEntity = step.recordEntity
42
- if (step.dependsOn?.length) snapshotStep.dependsOn = [...step.dependsOn]
43
- if (step.credentialRequirements?.length) {
44
- snapshotStep.credentialRequirements = step.credentialRequirements.map((requirement) => ({ ...requirement }))
45
- }
46
- if (step.recordColumns) {
47
- snapshotStep.recordColumns = {
48
- ...(step.recordColumns.company ? { company: step.recordColumns.company.map((column) => ({ ...column })) } : {}),
49
- ...(step.recordColumns.contact ? { contact: step.recordColumns.contact.map((column) => ({ ...column })) } : {})
50
- }
51
- }
52
-
53
- return snapshotStep
54
- })
55
- }
57
+ steps: template.steps.map((step: ListBuilderStep): BuildPlanSnapshotStep => {
58
+ const snapshotStep: BuildPlanSnapshotStep = {
59
+ id: step.id,
60
+ label: step.label,
61
+ primaryEntity: step.primaryEntity,
62
+ outputs: [...step.outputs],
63
+ stageKey: step.stageKey,
64
+ recordsStageKey: step.recordsStageKey ?? step.stageKey,
65
+ recordSourceStageKey: step.recordSourceStageKey ?? step.recordsStageKey ?? step.stageKey,
66
+ dependencyMode: step.dependencyMode,
67
+ actionKey: step.actionKey,
68
+ defaultBatchSize: step.defaultBatchSize,
69
+ maxBatchSize: step.maxBatchSize
70
+ }
71
+
72
+ if (step.description) snapshotStep.description = step.description
73
+ if (step.recordEntity) snapshotStep.recordEntity = step.recordEntity
74
+ if (step.dependsOn?.length) snapshotStep.dependsOn = [...step.dependsOn]
75
+ if (step.credentialRequirements?.length) {
76
+ snapshotStep.credentialRequirements = step.credentialRequirements.map((requirement: CredentialRequirement) => ({
77
+ ...requirement
78
+ }))
79
+ }
80
+ if (step.recordColumns) {
81
+ snapshotStep.recordColumns = {
82
+ ...(step.recordColumns.company
83
+ ? {
84
+ company: step.recordColumns.company.map((column: RecordColumnConfig) => ({ ...column }))
85
+ }
86
+ : {}),
87
+ ...(step.recordColumns.contact
88
+ ? {
89
+ contact: step.recordColumns.contact.map((column: RecordColumnConfig) => ({ ...column }))
90
+ }
91
+ : {})
92
+ }
93
+ }
94
+
95
+ return snapshotStep
96
+ })
97
+ }
56
98
  }