@elevasis/core 0.23.0 → 0.24.1

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 (243) hide show
  1. package/dist/index.d.ts +4343 -2690
  2. package/dist/index.js +1101 -156
  3. package/dist/knowledge/index.d.ts +574 -210
  4. package/dist/knowledge/index.js +104 -1
  5. package/dist/organization-model/index.d.ts +4343 -2690
  6. package/dist/organization-model/index.js +1101 -156
  7. package/dist/test-utils/index.d.ts +483 -109
  8. package/dist/test-utils/index.js +904 -144
  9. package/package.json +3 -3
  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 -12
  13. package/src/_gen/__tests__/__snapshots__/contracts.md.snap +2137 -2093
  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 +1492 -1497
  37. package/src/business/acquisition/build-templates.test.ts +240 -240
  38. package/src/business/acquisition/build-templates.ts +98 -98
  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 -153
  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 -396
  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 +195 -197
  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 +32 -32
  123. package/src/knowledge/__tests__/queries.test.ts +626 -535
  124. package/src/knowledge/format.ts +99 -99
  125. package/src/knowledge/index.ts +5 -5
  126. package/src/knowledge/published.ts +5 -5
  127. package/src/knowledge/queries.ts +269 -218
  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 -149
  131. package/src/organization-model/__tests__/content-kinds-registry.test.ts +210 -210
  132. package/src/organization-model/__tests__/defaults.test.ts +168 -168
  133. package/src/organization-model/__tests__/domains/actions.test.ts +78 -56
  134. package/src/organization-model/__tests__/domains/customers.test.ts +299 -299
  135. package/src/organization-model/__tests__/domains/entities.test.ts +56 -56
  136. package/src/organization-model/__tests__/domains/goals.test.ts +493 -493
  137. package/src/organization-model/__tests__/domains/identity.test.ts +280 -280
  138. package/src/organization-model/__tests__/domains/navigation.test.ts +268 -268
  139. package/src/organization-model/__tests__/domains/offerings.test.ts +414 -414
  140. package/src/organization-model/__tests__/domains/policies.test.ts +323 -323
  141. package/src/organization-model/__tests__/domains/resource-mappings.test.ts +293 -293
  142. package/src/organization-model/__tests__/domains/resources.test.ts +387 -277
  143. package/src/organization-model/__tests__/domains/roles.test.ts +463 -463
  144. package/src/organization-model/__tests__/domains/statuses.test.ts +246 -246
  145. package/src/organization-model/__tests__/domains/systems.test.ts +209 -209
  146. package/src/organization-model/__tests__/domains/topology.test.ts +188 -0
  147. package/src/organization-model/__tests__/flatten-additive-merge.test.ts +362 -361
  148. package/src/organization-model/__tests__/foundation.test.ts +77 -77
  149. package/src/organization-model/__tests__/get-resources-for-system.test.ts +144 -144
  150. package/src/organization-model/__tests__/graph.test.ts +1312 -862
  151. package/src/organization-model/__tests__/icons.test.ts +10 -1
  152. package/src/organization-model/__tests__/knowledge.test.ts +251 -15
  153. package/src/organization-model/__tests__/lookup-helpers.test.ts +438 -438
  154. package/src/organization-model/__tests__/migration-helpers.test.ts +591 -591
  155. package/src/organization-model/__tests__/prospecting-ssot.test.ts +103 -103
  156. package/src/organization-model/__tests__/recursive-system-schema.test.ts +535 -506
  157. package/src/organization-model/__tests__/resolve.test.ts +274 -164
  158. package/src/organization-model/__tests__/schema.test.ts +844 -301
  159. package/src/organization-model/__tests__/surface-projection.test.ts +284 -284
  160. package/src/organization-model/catalogs/lead-gen.ts +144 -144
  161. package/src/organization-model/content-kinds/config.ts +36 -36
  162. package/src/organization-model/content-kinds/index.ts +76 -72
  163. package/src/organization-model/content-kinds/pipeline.ts +68 -68
  164. package/src/organization-model/content-kinds/registry.ts +44 -44
  165. package/src/organization-model/content-kinds/status.ts +71 -71
  166. package/src/organization-model/content-kinds/template.ts +83 -83
  167. package/src/organization-model/content-kinds/types.ts +117 -117
  168. package/src/organization-model/contracts.ts +27 -27
  169. package/src/organization-model/defaults.ts +42 -50
  170. package/src/organization-model/domains/actions.ts +333 -239
  171. package/src/organization-model/domains/customers.ts +78 -78
  172. package/src/organization-model/domains/entities.ts +144 -144
  173. package/src/organization-model/domains/goals.ts +83 -83
  174. package/src/organization-model/domains/knowledge.ts +117 -101
  175. package/src/organization-model/domains/navigation.ts +139 -139
  176. package/src/organization-model/domains/offerings.ts +71 -71
  177. package/src/organization-model/domains/policies.ts +102 -102
  178. package/src/organization-model/domains/projects.ts +14 -14
  179. package/src/organization-model/domains/prospecting.ts +395 -395
  180. package/src/organization-model/domains/resources.ts +202 -124
  181. package/src/organization-model/domains/roles.ts +96 -96
  182. package/src/organization-model/domains/sales.test.ts +218 -218
  183. package/src/organization-model/domains/sales.ts +380 -380
  184. package/src/organization-model/domains/shared.ts +63 -63
  185. package/src/organization-model/domains/statuses.ts +339 -339
  186. package/src/organization-model/domains/systems.ts +217 -172
  187. package/src/organization-model/domains/topology.ts +261 -0
  188. package/src/organization-model/foundation.ts +75 -75
  189. package/src/organization-model/graph/build.ts +1043 -867
  190. package/src/organization-model/graph/index.ts +4 -4
  191. package/src/organization-model/graph/link.ts +10 -10
  192. package/src/organization-model/graph/schema.ts +75 -68
  193. package/src/organization-model/graph/types.ts +71 -64
  194. package/src/organization-model/helpers.ts +289 -241
  195. package/src/organization-model/icons.ts +78 -66
  196. package/src/organization-model/index.ts +128 -125
  197. package/src/organization-model/migration-helpers.ts +247 -244
  198. package/src/organization-model/ontology.ts +658 -0
  199. package/src/organization-model/organization-graph.mdx +110 -90
  200. package/src/organization-model/organization-model.mdx +225 -213
  201. package/src/organization-model/published.ts +299 -222
  202. package/src/organization-model/resolve.ts +146 -91
  203. package/src/organization-model/schema.ts +818 -659
  204. package/src/organization-model/surface-projection.ts +212 -212
  205. package/src/organization-model/types.ts +179 -155
  206. package/src/platform/api/types.ts +38 -38
  207. package/src/platform/constants/versions.ts +3 -3
  208. package/src/platform/index.ts +23 -23
  209. package/src/platform/registry/__tests__/command-view.test.ts +10 -10
  210. package/src/platform/registry/__tests__/resource-link.test.ts +35 -35
  211. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +20 -20
  212. package/src/platform/registry/__tests__/resource-registry.nested-systems.test.ts +245 -245
  213. package/src/platform/registry/__tests__/resource-registry.test.ts +2053 -2053
  214. package/src/platform/registry/__tests__/validation.test.ts +1444 -1259
  215. package/src/platform/registry/command-view.ts +10 -10
  216. package/src/platform/registry/index.ts +103 -103
  217. package/src/platform/registry/resource-link.ts +32 -32
  218. package/src/platform/registry/resource-registry.ts +886 -886
  219. package/src/platform/registry/serialization.ts +295 -295
  220. package/src/platform/registry/serialized-types.ts +166 -166
  221. package/src/platform/registry/stats-types.ts +68 -68
  222. package/src/platform/registry/types.ts +425 -425
  223. package/src/platform/registry/validation.ts +876 -684
  224. package/src/platform/utils/__tests__/validation.test.ts +1084 -1084
  225. package/src/platform/utils/validation.ts +425 -425
  226. package/src/projects/api-schemas.test.ts +39 -39
  227. package/src/projects/api-schemas.ts +291 -291
  228. package/src/reference/_generated/contracts.md +2136 -2093
  229. package/src/reference/glossary.md +76 -76
  230. package/src/scaffold-registry/__tests__/index.test.ts +206 -206
  231. package/src/scaffold-registry/__tests__/schema.test.ts +166 -166
  232. package/src/scaffold-registry/index.ts +392 -392
  233. package/src/scaffold-registry/schema.ts +243 -243
  234. package/src/server.ts +289 -289
  235. package/src/supabase/database.types.ts +3 -0
  236. package/src/test-utils/README.md +37 -37
  237. package/src/test-utils/entities.ts +108 -108
  238. package/src/test-utils/fixtures/memberships.ts +82 -82
  239. package/src/test-utils/index.ts +12 -12
  240. package/src/test-utils/organization-model.ts +65 -65
  241. package/src/test-utils/published.ts +6 -6
  242. package/src/test-utils/rls/RLSTestContext.ts +588 -588
  243. package/src/test-utils/test-utils.test.ts +44 -44
@@ -1,327 +1,327 @@
1
- /**
2
- * Webhook Endpoint API schemas tests
3
- * Tests validation schemas for webhook endpoint CRUD API
4
- * Focus: Mass assignment prevention, required field enforcement, partial update rules, type coercion
5
- */
6
-
7
- import { describe, it, expect } from 'vitest'
8
- import {
9
- CreateWebhookEndpointRequestSchema,
10
- UpdateWebhookEndpointRequestSchema,
11
- ListWebhookEndpointsQuerySchema,
12
- WebhookEndpointResponseSchema
13
- } from '../api-schemas'
14
-
15
- const validUuid = 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'
16
- const validUuid2 = 'b1eebc99-9c0b-4ef8-bb6d-6bb9bd380a22'
17
-
18
- describe('CreateWebhookEndpointRequestSchema', () => {
19
- const validPayload = {
20
- name: 'My Inbound Webhook',
21
- resourceId: 'my-workflow-workflow'
22
- }
23
-
24
- describe('valid requests', () => {
25
- it('accepts name and resourceId', () => {
26
- const result = CreateWebhookEndpointRequestSchema.parse(validPayload)
27
- expect(result.name).toBe('My Inbound Webhook')
28
- expect(result.resourceId).toBe('my-workflow-workflow')
29
- })
30
-
31
- it('accepts optional description', () => {
32
- const payload = { ...validPayload, description: 'Receives Stripe events' }
33
- const result = CreateWebhookEndpointRequestSchema.parse(payload)
34
- expect(result.description).toBe('Receives Stripe events')
35
- })
36
-
37
- it('omits description when not provided', () => {
38
- const result = CreateWebhookEndpointRequestSchema.parse(validPayload)
39
- expect(result.description).toBeUndefined()
40
- })
41
-
42
- it('accepts empty string description (description is z.string, not NonEmptyString)', () => {
43
- const payload = { ...validPayload, description: '' }
44
- const result = CreateWebhookEndpointRequestSchema.parse(payload)
45
- expect(result.description).toBe('')
46
- })
47
- })
48
-
49
- describe('required fields', () => {
50
- it('rejects missing name', () => {
51
- const { name: _name, ...payload } = validPayload
52
- expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
53
- })
54
-
55
- it('accepts missing resourceId (optional field)', () => {
56
- const { resourceId: _resourceId, ...payload } = validPayload
57
- const result = CreateWebhookEndpointRequestSchema.parse(payload)
58
- expect(result.resourceId).toBeUndefined()
59
- })
60
-
61
- it('rejects empty name (NonEmptyString enforcement)', () => {
62
- expect(() => CreateWebhookEndpointRequestSchema.parse({ ...validPayload, name: '' })).toThrow()
63
- })
64
-
65
- it('rejects empty resourceId (NonEmptyString enforcement)', () => {
66
- expect(() => CreateWebhookEndpointRequestSchema.parse({ ...validPayload, resourceId: '' })).toThrow()
67
- })
68
- })
69
-
70
- describe('SECURITY: mass assignment prevention', () => {
71
- it('rejects organizationId injection', () => {
72
- const payload = { ...validPayload, organizationId: 'attacker-org-id' }
73
- expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
74
- })
75
-
76
- it('rejects id injection (server-generated field)', () => {
77
- const payload = { ...validPayload, id: validUuid }
78
- expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
79
- })
80
-
81
- it('rejects key injection (server-generated field)', () => {
82
- const payload = { ...validPayload, key: 'whk_custom_key' }
83
- expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
84
- })
85
-
86
- it('rejects status injection', () => {
87
- const payload = { ...validPayload, status: 'active' }
88
- expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
89
- })
90
-
91
- it('rejects arbitrary unknown fields', () => {
92
- const payload = { ...validPayload, malicious: 'value' }
93
- expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
94
- })
95
- })
96
- })
97
-
98
- describe('UpdateWebhookEndpointRequestSchema', () => {
99
- describe('valid partial updates', () => {
100
- it('accepts update with name only', () => {
101
- const result = UpdateWebhookEndpointRequestSchema.parse({ name: 'New Name' })
102
- expect(result.name).toBe('New Name')
103
- expect(result.status).toBeUndefined()
104
- })
105
-
106
- it('accepts update with status only', () => {
107
- const result = UpdateWebhookEndpointRequestSchema.parse({ status: 'paused' })
108
- expect(result.status).toBe('paused')
109
- })
110
-
111
- it('accepts update with resourceId only', () => {
112
- const result = UpdateWebhookEndpointRequestSchema.parse({ resourceId: 'other-workflow-workflow' })
113
- expect(result.resourceId).toBe('other-workflow-workflow')
114
- })
115
-
116
- it('accepts update with description only', () => {
117
- const result = UpdateWebhookEndpointRequestSchema.parse({ description: 'Updated desc' })
118
- expect(result.description).toBe('Updated desc')
119
- })
120
-
121
- it('accepts update with all fields', () => {
122
- const payload = {
123
- name: 'Updated',
124
- description: 'New desc',
125
- resourceId: 'new-workflow-workflow',
126
- status: 'active' as const
127
- }
128
- const result = UpdateWebhookEndpointRequestSchema.parse(payload)
129
- expect(result).toEqual(payload)
130
- })
131
- })
132
-
133
- describe('status values', () => {
134
- it('accepts active status', () => {
135
- const result = UpdateWebhookEndpointRequestSchema.parse({ status: 'active' })
136
- expect(result.status).toBe('active')
137
- })
138
-
139
- it('accepts paused status', () => {
140
- const result = UpdateWebhookEndpointRequestSchema.parse({ status: 'paused' })
141
- expect(result.status).toBe('paused')
142
- })
143
-
144
- it('rejects invalid status value', () => {
145
- expect(() => UpdateWebhookEndpointRequestSchema.parse({ status: 'disabled' })).toThrow()
146
- })
147
-
148
- it('rejects empty string status', () => {
149
- expect(() => UpdateWebhookEndpointRequestSchema.parse({ status: '' })).toThrow()
150
- })
151
- })
152
-
153
- describe('at least one field required', () => {
154
- it('rejects empty object', () => {
155
- expect(() => UpdateWebhookEndpointRequestSchema.parse({})).toThrow(
156
- 'At least one field (name, description, resourceId, or status) must be provided'
157
- )
158
- })
159
-
160
- it('rejects object with all fields explicitly undefined', () => {
161
- expect(() =>
162
- UpdateWebhookEndpointRequestSchema.parse({
163
- name: undefined,
164
- description: undefined,
165
- resourceId: undefined,
166
- status: undefined
167
- })
168
- ).toThrow('At least one field')
169
- })
170
- })
171
-
172
- describe('SECURITY: mass assignment prevention', () => {
173
- it('rejects organizationId injection', () => {
174
- const payload = { name: 'Valid', organizationId: 'attacker-org' }
175
- expect(() => UpdateWebhookEndpointRequestSchema.parse(payload)).toThrow()
176
- })
177
-
178
- it('rejects id injection', () => {
179
- const payload = { name: 'Valid', id: validUuid }
180
- expect(() => UpdateWebhookEndpointRequestSchema.parse(payload)).toThrow()
181
- })
182
-
183
- it('rejects unknown fields', () => {
184
- const payload = { name: 'Valid', unknownField: 'value' }
185
- expect(() => UpdateWebhookEndpointRequestSchema.parse(payload)).toThrow()
186
- })
187
- })
188
- })
189
-
190
- describe('ListWebhookEndpointsQuerySchema', () => {
191
- describe('defaults', () => {
192
- it('accepts empty query and applies defaults', () => {
193
- const result = ListWebhookEndpointsQuerySchema.parse({})
194
- expect(result.limit).toBe(20)
195
- expect(result.offset).toBe(0)
196
- expect(result.status).toBeUndefined()
197
- })
198
- })
199
-
200
- describe('status filter', () => {
201
- it('accepts active status filter', () => {
202
- const result = ListWebhookEndpointsQuerySchema.parse({ status: 'active' })
203
- expect(result.status).toBe('active')
204
- })
205
-
206
- it('accepts paused status filter', () => {
207
- const result = ListWebhookEndpointsQuerySchema.parse({ status: 'paused' })
208
- expect(result.status).toBe('paused')
209
- })
210
-
211
- it('rejects invalid status value', () => {
212
- expect(() => ListWebhookEndpointsQuerySchema.parse({ status: 'deleted' })).toThrow()
213
- })
214
- })
215
-
216
- describe('string coercion (querystring params arrive as strings)', () => {
217
- it('coerces string limit to number', () => {
218
- const result = ListWebhookEndpointsQuerySchema.parse({ limit: '50' })
219
- expect(result.limit).toBe(50)
220
- })
221
-
222
- it('coerces string offset to number', () => {
223
- const result = ListWebhookEndpointsQuerySchema.parse({ offset: '100' })
224
- expect(result.offset).toBe(100)
225
- })
226
-
227
- it('coerces both limit and offset together', () => {
228
- const result = ListWebhookEndpointsQuerySchema.parse({ limit: '10', offset: '30' })
229
- expect(result.limit).toBe(10)
230
- expect(result.offset).toBe(30)
231
- })
232
-
233
- it('rejects limit above max (100)', () => {
234
- expect(() => ListWebhookEndpointsQuerySchema.parse({ limit: '101' })).toThrow()
235
- })
236
-
237
- it('rejects negative offset', () => {
238
- expect(() => ListWebhookEndpointsQuerySchema.parse({ offset: '-1' })).toThrow()
239
- })
240
- })
241
- })
242
-
243
- describe('WebhookEndpointResponseSchema', () => {
244
- const validResponse = {
245
- id: validUuid,
246
- organizationId: validUuid2,
247
- key: 'whk_abc123def456',
248
- keyPrefix: 'whk_abc1',
249
- name: 'Stripe Inbound',
250
- description: 'Handles Stripe webhook events',
251
- resourceId: 'stripe-handler-workflow',
252
- status: 'active' as const,
253
- lastTriggeredAt: '2026-03-01T12:00:00.000Z',
254
- requestCount: 42,
255
- createdAt: '2026-01-01T00:00:00.000Z',
256
- updatedAt: '2026-03-01T12:00:00.000Z'
257
- }
258
-
259
- it('accepts a complete valid response object (with key — create response)', () => {
260
- const result = WebhookEndpointResponseSchema.parse(validResponse)
261
- expect(result.id).toBe(validUuid)
262
- expect(result.status).toBe('active')
263
- expect(result.requestCount).toBe(42)
264
- expect(result.key).toBe('whk_abc123def456')
265
- })
266
-
267
- it('accepts a response without key (list/get response — key is optional)', () => {
268
- const { key: _key, ...responseWithoutKey } = validResponse
269
- const result = WebhookEndpointResponseSchema.parse(responseWithoutKey)
270
- expect(result.id).toBe(validUuid)
271
- expect(result.key).toBeUndefined()
272
- })
273
-
274
- describe('nullable fields', () => {
275
- it('accepts null description', () => {
276
- const result = WebhookEndpointResponseSchema.parse({ ...validResponse, description: null })
277
- expect(result.description).toBeNull()
278
- })
279
-
280
- it('accepts null lastTriggeredAt (endpoint never triggered)', () => {
281
- const result = WebhookEndpointResponseSchema.parse({ ...validResponse, lastTriggeredAt: null })
282
- expect(result.lastTriggeredAt).toBeNull()
283
- })
284
-
285
- it('accepts both nullable fields as null', () => {
286
- const result = WebhookEndpointResponseSchema.parse({
287
- ...validResponse,
288
- description: null,
289
- lastTriggeredAt: null
290
- })
291
- expect(result.description).toBeNull()
292
- expect(result.lastTriggeredAt).toBeNull()
293
- })
294
- })
295
-
296
- describe('forward compatibility (not strict)', () => {
297
- it('accepts extra fields in response (allows API additions without breaking clients)', () => {
298
- const result = WebhookEndpointResponseSchema.parse({
299
- ...validResponse,
300
- newFieldFromFutureApiVersion: 'some-value'
301
- })
302
- expect(result.id).toBe(validUuid)
303
- })
304
- })
305
-
306
- describe('field validation', () => {
307
- it('rejects invalid UUID for id', () => {
308
- expect(() => WebhookEndpointResponseSchema.parse({ ...validResponse, id: 'not-a-uuid' })).toThrow()
309
- })
310
-
311
- it('rejects invalid UUID for organizationId', () => {
312
- expect(() => WebhookEndpointResponseSchema.parse({ ...validResponse, organizationId: 'not-a-uuid' })).toThrow()
313
- })
314
-
315
- it('rejects negative requestCount', () => {
316
- expect(() => WebhookEndpointResponseSchema.parse({ ...validResponse, requestCount: -1 })).toThrow()
317
- })
318
-
319
- it('rejects invalid datetime for createdAt', () => {
320
- expect(() => WebhookEndpointResponseSchema.parse({ ...validResponse, createdAt: 'not-a-date' })).toThrow()
321
- })
322
-
323
- it('rejects invalid status in response', () => {
324
- expect(() => WebhookEndpointResponseSchema.parse({ ...validResponse, status: 'unknown' })).toThrow()
325
- })
326
- })
327
- })
1
+ /**
2
+ * Webhook Endpoint API schemas tests
3
+ * Tests validation schemas for webhook endpoint CRUD API
4
+ * Focus: Mass assignment prevention, required field enforcement, partial update rules, type coercion
5
+ */
6
+
7
+ import { describe, it, expect } from 'vitest'
8
+ import {
9
+ CreateWebhookEndpointRequestSchema,
10
+ UpdateWebhookEndpointRequestSchema,
11
+ ListWebhookEndpointsQuerySchema,
12
+ WebhookEndpointResponseSchema
13
+ } from '../api-schemas'
14
+
15
+ const validUuid = 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'
16
+ const validUuid2 = 'b1eebc99-9c0b-4ef8-bb6d-6bb9bd380a22'
17
+
18
+ describe('CreateWebhookEndpointRequestSchema', () => {
19
+ const validPayload = {
20
+ name: 'My Inbound Webhook',
21
+ resourceId: 'my-workflow-workflow'
22
+ }
23
+
24
+ describe('valid requests', () => {
25
+ it('accepts name and resourceId', () => {
26
+ const result = CreateWebhookEndpointRequestSchema.parse(validPayload)
27
+ expect(result.name).toBe('My Inbound Webhook')
28
+ expect(result.resourceId).toBe('my-workflow-workflow')
29
+ })
30
+
31
+ it('accepts optional description', () => {
32
+ const payload = { ...validPayload, description: 'Receives Stripe events' }
33
+ const result = CreateWebhookEndpointRequestSchema.parse(payload)
34
+ expect(result.description).toBe('Receives Stripe events')
35
+ })
36
+
37
+ it('omits description when not provided', () => {
38
+ const result = CreateWebhookEndpointRequestSchema.parse(validPayload)
39
+ expect(result.description).toBeUndefined()
40
+ })
41
+
42
+ it('accepts empty string description (description is z.string, not NonEmptyString)', () => {
43
+ const payload = { ...validPayload, description: '' }
44
+ const result = CreateWebhookEndpointRequestSchema.parse(payload)
45
+ expect(result.description).toBe('')
46
+ })
47
+ })
48
+
49
+ describe('required fields', () => {
50
+ it('rejects missing name', () => {
51
+ const { name: _name, ...payload } = validPayload
52
+ expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
53
+ })
54
+
55
+ it('accepts missing resourceId (optional field)', () => {
56
+ const { resourceId: _resourceId, ...payload } = validPayload
57
+ const result = CreateWebhookEndpointRequestSchema.parse(payload)
58
+ expect(result.resourceId).toBeUndefined()
59
+ })
60
+
61
+ it('rejects empty name (NonEmptyString enforcement)', () => {
62
+ expect(() => CreateWebhookEndpointRequestSchema.parse({ ...validPayload, name: '' })).toThrow()
63
+ })
64
+
65
+ it('rejects empty resourceId (NonEmptyString enforcement)', () => {
66
+ expect(() => CreateWebhookEndpointRequestSchema.parse({ ...validPayload, resourceId: '' })).toThrow()
67
+ })
68
+ })
69
+
70
+ describe('SECURITY: mass assignment prevention', () => {
71
+ it('rejects organizationId injection', () => {
72
+ const payload = { ...validPayload, organizationId: 'attacker-org-id' }
73
+ expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
74
+ })
75
+
76
+ it('rejects id injection (server-generated field)', () => {
77
+ const payload = { ...validPayload, id: validUuid }
78
+ expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
79
+ })
80
+
81
+ it('rejects key injection (server-generated field)', () => {
82
+ const payload = { ...validPayload, key: 'whk_custom_key' }
83
+ expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
84
+ })
85
+
86
+ it('rejects status injection', () => {
87
+ const payload = { ...validPayload, status: 'active' }
88
+ expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
89
+ })
90
+
91
+ it('rejects arbitrary unknown fields', () => {
92
+ const payload = { ...validPayload, malicious: 'value' }
93
+ expect(() => CreateWebhookEndpointRequestSchema.parse(payload)).toThrow()
94
+ })
95
+ })
96
+ })
97
+
98
+ describe('UpdateWebhookEndpointRequestSchema', () => {
99
+ describe('valid partial updates', () => {
100
+ it('accepts update with name only', () => {
101
+ const result = UpdateWebhookEndpointRequestSchema.parse({ name: 'New Name' })
102
+ expect(result.name).toBe('New Name')
103
+ expect(result.status).toBeUndefined()
104
+ })
105
+
106
+ it('accepts update with status only', () => {
107
+ const result = UpdateWebhookEndpointRequestSchema.parse({ status: 'paused' })
108
+ expect(result.status).toBe('paused')
109
+ })
110
+
111
+ it('accepts update with resourceId only', () => {
112
+ const result = UpdateWebhookEndpointRequestSchema.parse({ resourceId: 'other-workflow-workflow' })
113
+ expect(result.resourceId).toBe('other-workflow-workflow')
114
+ })
115
+
116
+ it('accepts update with description only', () => {
117
+ const result = UpdateWebhookEndpointRequestSchema.parse({ description: 'Updated desc' })
118
+ expect(result.description).toBe('Updated desc')
119
+ })
120
+
121
+ it('accepts update with all fields', () => {
122
+ const payload = {
123
+ name: 'Updated',
124
+ description: 'New desc',
125
+ resourceId: 'new-workflow-workflow',
126
+ status: 'active' as const
127
+ }
128
+ const result = UpdateWebhookEndpointRequestSchema.parse(payload)
129
+ expect(result).toEqual(payload)
130
+ })
131
+ })
132
+
133
+ describe('status values', () => {
134
+ it('accepts active status', () => {
135
+ const result = UpdateWebhookEndpointRequestSchema.parse({ status: 'active' })
136
+ expect(result.status).toBe('active')
137
+ })
138
+
139
+ it('accepts paused status', () => {
140
+ const result = UpdateWebhookEndpointRequestSchema.parse({ status: 'paused' })
141
+ expect(result.status).toBe('paused')
142
+ })
143
+
144
+ it('rejects invalid status value', () => {
145
+ expect(() => UpdateWebhookEndpointRequestSchema.parse({ status: 'disabled' })).toThrow()
146
+ })
147
+
148
+ it('rejects empty string status', () => {
149
+ expect(() => UpdateWebhookEndpointRequestSchema.parse({ status: '' })).toThrow()
150
+ })
151
+ })
152
+
153
+ describe('at least one field required', () => {
154
+ it('rejects empty object', () => {
155
+ expect(() => UpdateWebhookEndpointRequestSchema.parse({})).toThrow(
156
+ 'At least one field (name, description, resourceId, or status) must be provided'
157
+ )
158
+ })
159
+
160
+ it('rejects object with all fields explicitly undefined', () => {
161
+ expect(() =>
162
+ UpdateWebhookEndpointRequestSchema.parse({
163
+ name: undefined,
164
+ description: undefined,
165
+ resourceId: undefined,
166
+ status: undefined
167
+ })
168
+ ).toThrow('At least one field')
169
+ })
170
+ })
171
+
172
+ describe('SECURITY: mass assignment prevention', () => {
173
+ it('rejects organizationId injection', () => {
174
+ const payload = { name: 'Valid', organizationId: 'attacker-org' }
175
+ expect(() => UpdateWebhookEndpointRequestSchema.parse(payload)).toThrow()
176
+ })
177
+
178
+ it('rejects id injection', () => {
179
+ const payload = { name: 'Valid', id: validUuid }
180
+ expect(() => UpdateWebhookEndpointRequestSchema.parse(payload)).toThrow()
181
+ })
182
+
183
+ it('rejects unknown fields', () => {
184
+ const payload = { name: 'Valid', unknownField: 'value' }
185
+ expect(() => UpdateWebhookEndpointRequestSchema.parse(payload)).toThrow()
186
+ })
187
+ })
188
+ })
189
+
190
+ describe('ListWebhookEndpointsQuerySchema', () => {
191
+ describe('defaults', () => {
192
+ it('accepts empty query and applies defaults', () => {
193
+ const result = ListWebhookEndpointsQuerySchema.parse({})
194
+ expect(result.limit).toBe(20)
195
+ expect(result.offset).toBe(0)
196
+ expect(result.status).toBeUndefined()
197
+ })
198
+ })
199
+
200
+ describe('status filter', () => {
201
+ it('accepts active status filter', () => {
202
+ const result = ListWebhookEndpointsQuerySchema.parse({ status: 'active' })
203
+ expect(result.status).toBe('active')
204
+ })
205
+
206
+ it('accepts paused status filter', () => {
207
+ const result = ListWebhookEndpointsQuerySchema.parse({ status: 'paused' })
208
+ expect(result.status).toBe('paused')
209
+ })
210
+
211
+ it('rejects invalid status value', () => {
212
+ expect(() => ListWebhookEndpointsQuerySchema.parse({ status: 'deleted' })).toThrow()
213
+ })
214
+ })
215
+
216
+ describe('string coercion (querystring params arrive as strings)', () => {
217
+ it('coerces string limit to number', () => {
218
+ const result = ListWebhookEndpointsQuerySchema.parse({ limit: '50' })
219
+ expect(result.limit).toBe(50)
220
+ })
221
+
222
+ it('coerces string offset to number', () => {
223
+ const result = ListWebhookEndpointsQuerySchema.parse({ offset: '100' })
224
+ expect(result.offset).toBe(100)
225
+ })
226
+
227
+ it('coerces both limit and offset together', () => {
228
+ const result = ListWebhookEndpointsQuerySchema.parse({ limit: '10', offset: '30' })
229
+ expect(result.limit).toBe(10)
230
+ expect(result.offset).toBe(30)
231
+ })
232
+
233
+ it('rejects limit above max (100)', () => {
234
+ expect(() => ListWebhookEndpointsQuerySchema.parse({ limit: '101' })).toThrow()
235
+ })
236
+
237
+ it('rejects negative offset', () => {
238
+ expect(() => ListWebhookEndpointsQuerySchema.parse({ offset: '-1' })).toThrow()
239
+ })
240
+ })
241
+ })
242
+
243
+ describe('WebhookEndpointResponseSchema', () => {
244
+ const validResponse = {
245
+ id: validUuid,
246
+ organizationId: validUuid2,
247
+ key: 'whk_abc123def456',
248
+ keyPrefix: 'whk_abc1',
249
+ name: 'Stripe Inbound',
250
+ description: 'Handles Stripe webhook events',
251
+ resourceId: 'stripe-handler-workflow',
252
+ status: 'active' as const,
253
+ lastTriggeredAt: '2026-03-01T12:00:00.000Z',
254
+ requestCount: 42,
255
+ createdAt: '2026-01-01T00:00:00.000Z',
256
+ updatedAt: '2026-03-01T12:00:00.000Z'
257
+ }
258
+
259
+ it('accepts a complete valid response object (with key — create response)', () => {
260
+ const result = WebhookEndpointResponseSchema.parse(validResponse)
261
+ expect(result.id).toBe(validUuid)
262
+ expect(result.status).toBe('active')
263
+ expect(result.requestCount).toBe(42)
264
+ expect(result.key).toBe('whk_abc123def456')
265
+ })
266
+
267
+ it('accepts a response without key (list/get response — key is optional)', () => {
268
+ const { key: _key, ...responseWithoutKey } = validResponse
269
+ const result = WebhookEndpointResponseSchema.parse(responseWithoutKey)
270
+ expect(result.id).toBe(validUuid)
271
+ expect(result.key).toBeUndefined()
272
+ })
273
+
274
+ describe('nullable fields', () => {
275
+ it('accepts null description', () => {
276
+ const result = WebhookEndpointResponseSchema.parse({ ...validResponse, description: null })
277
+ expect(result.description).toBeNull()
278
+ })
279
+
280
+ it('accepts null lastTriggeredAt (endpoint never triggered)', () => {
281
+ const result = WebhookEndpointResponseSchema.parse({ ...validResponse, lastTriggeredAt: null })
282
+ expect(result.lastTriggeredAt).toBeNull()
283
+ })
284
+
285
+ it('accepts both nullable fields as null', () => {
286
+ const result = WebhookEndpointResponseSchema.parse({
287
+ ...validResponse,
288
+ description: null,
289
+ lastTriggeredAt: null
290
+ })
291
+ expect(result.description).toBeNull()
292
+ expect(result.lastTriggeredAt).toBeNull()
293
+ })
294
+ })
295
+
296
+ describe('forward compatibility (not strict)', () => {
297
+ it('accepts extra fields in response (allows API additions without breaking clients)', () => {
298
+ const result = WebhookEndpointResponseSchema.parse({
299
+ ...validResponse,
300
+ newFieldFromFutureApiVersion: 'some-value'
301
+ })
302
+ expect(result.id).toBe(validUuid)
303
+ })
304
+ })
305
+
306
+ describe('field validation', () => {
307
+ it('rejects invalid UUID for id', () => {
308
+ expect(() => WebhookEndpointResponseSchema.parse({ ...validResponse, id: 'not-a-uuid' })).toThrow()
309
+ })
310
+
311
+ it('rejects invalid UUID for organizationId', () => {
312
+ expect(() => WebhookEndpointResponseSchema.parse({ ...validResponse, organizationId: 'not-a-uuid' })).toThrow()
313
+ })
314
+
315
+ it('rejects negative requestCount', () => {
316
+ expect(() => WebhookEndpointResponseSchema.parse({ ...validResponse, requestCount: -1 })).toThrow()
317
+ })
318
+
319
+ it('rejects invalid datetime for createdAt', () => {
320
+ expect(() => WebhookEndpointResponseSchema.parse({ ...validResponse, createdAt: 'not-a-date' })).toThrow()
321
+ })
322
+
323
+ it('rejects invalid status in response', () => {
324
+ expect(() => WebhookEndpointResponseSchema.parse({ ...validResponse, status: 'unknown' })).toThrow()
325
+ })
326
+ })
327
+ })