spine-framework 0.1.61 → 1.0.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 (425) hide show
  1. package/LICENSE.md +223 -0
  2. package/README.md +327 -0
  3. package/package.json +107 -216
  4. package/src/cli/commands/init.ts +192 -0
  5. package/src/cli/commands/install.ts +25 -0
  6. package/src/cli/commands/list.ts +33 -0
  7. package/src/cli/commands/migrate.ts +24 -0
  8. package/src/cli/index.ts +46 -0
  9. package/src/components/AppLayout.tsx +21 -0
  10. package/src/components/AuthGuard.tsx +21 -0
  11. package/src/components/RoleGuard.tsx +23 -0
  12. package/src/components/index.ts +3 -0
  13. package/src/contexts/AppContext.tsx +122 -0
  14. package/src/contexts/AuthContext.tsx +87 -0
  15. package/src/contexts/SpineContext.tsx +46 -0
  16. package/src/contexts/index.ts +3 -0
  17. package/src/hooks/index.ts +4 -0
  18. package/src/hooks/useItems.ts +78 -0
  19. package/src/hooks/useThreads.ts +73 -0
  20. package/src/hooks/useWebSocket.ts +97 -0
  21. package/src/index.ts +22 -0
  22. package/src/types/index.ts +163 -0
  23. package/src/utils/api.ts +88 -0
  24. package/src/utils/client.ts +146 -0
  25. package/src/utils/config.ts +20 -0
  26. package/src/utils/index.ts +3 -0
  27. package/.framework/README.md +0 -129
  28. package/.framework/cli/bin.cjs +0 -14
  29. package/.framework/cli/commands/agents.ts +0 -153
  30. package/.framework/cli/commands/auth.ts +0 -94
  31. package/.framework/cli/commands/create-app.ts +0 -185
  32. package/.framework/cli/commands/dev.ts +0 -113
  33. package/.framework/cli/commands/doctor.ts +0 -442
  34. package/.framework/cli/commands/generate.ts +0 -332
  35. package/.framework/cli/commands/init.ts +0 -186
  36. package/.framework/cli/commands/install-app.ts +0 -565
  37. package/.framework/cli/commands/items.ts +0 -253
  38. package/.framework/cli/commands/migrate.ts +0 -139
  39. package/.framework/cli/commands/migrations.ts +0 -141
  40. package/.framework/cli/commands/pipelines.ts +0 -166
  41. package/.framework/cli/commands/status.ts +0 -197
  42. package/.framework/cli/commands/system.ts +0 -184
  43. package/.framework/cli/commands/test.ts +0 -227
  44. package/.framework/cli/commands/uninstall-app.ts +0 -166
  45. package/.framework/cli/context.ts +0 -268
  46. package/.framework/cli/env-loader.ts +0 -36
  47. package/.framework/cli/index.ts +0 -116
  48. package/.framework/cli/welcome.cjs +0 -45
  49. package/.framework/docs/API.md +0 -384
  50. package/.framework/docs/STABILITY.md +0 -52
  51. package/.framework/docs/admin-routes.md +0 -76
  52. package/.framework/docs/api-docs-progress.md +0 -38
  53. package/.framework/docs/api-governance.md +0 -146
  54. package/.framework/docs/api-testing-results.md +0 -212
  55. package/.framework/docs/apis/admin-configs.md +0 -567
  56. package/.framework/docs/apis/admin-data.md +0 -272
  57. package/.framework/docs/apis/index.md +0 -231
  58. package/.framework/docs/apis/internal.md +0 -295
  59. package/.framework/docs/apis/runtime.md +0 -537
  60. package/.framework/docs/assembly-launch-guide.md +0 -138
  61. package/.framework/docs/audit-results.md +0 -590
  62. package/.framework/docs/authorization-model.md +0 -170
  63. package/.framework/docs/db-api-inventory.md +0 -95
  64. package/.framework/docs/examples/custom-app/README.md +0 -77
  65. package/.framework/docs/examples/custom-function/README.md +0 -27
  66. package/.framework/docs/examples/custom-function/handler.ts +0 -48
  67. package/.framework/docs/examples/custom-webhook/README.md +0 -68
  68. package/.framework/docs/gap-remediation-backlog.md +0 -103
  69. package/.framework/docs/guides/cli-guide.md +0 -224
  70. package/.framework/docs/guides/getting-started.md +0 -103
  71. package/.framework/docs/guides/import-guide.md +0 -193
  72. package/.framework/docs/guides/testing-guide.md +0 -229
  73. package/.framework/docs/permission-examples.md +0 -326
  74. package/.framework/docs/ui-adoption-verification.md +0 -111
  75. package/.framework/docs/ui-api-coverage.md +0 -84
  76. package/.framework/docs/v2-compatibility-audit.md +0 -228
  77. package/.framework/functions/.gitkeep +0 -1
  78. package/.framework/functions/_shared/agent-runner.ts +0 -1097
  79. package/.framework/functions/_shared/app-manifest.ts +0 -184
  80. package/.framework/functions/_shared/audit.ts +0 -150
  81. package/.framework/functions/_shared/db.ts +0 -178
  82. package/.framework/functions/_shared/index.ts +0 -391
  83. package/.framework/functions/_shared/middleware.ts +0 -490
  84. package/.framework/functions/_shared/permissions.ts +0 -1325
  85. package/.framework/functions/_shared/pipeline-runner.ts +0 -731
  86. package/.framework/functions/_shared/principal.ts +0 -818
  87. package/.framework/functions/_shared/resolve-ids.ts +0 -106
  88. package/.framework/functions/_shared/schema-utils.ts +0 -967
  89. package/.framework/functions/_shared/testing.ts +0 -258
  90. package/.framework/functions/_shared/trigger-engine.ts +0 -425
  91. package/.framework/functions/_shared/webhook-registration.ts +0 -168
  92. package/.framework/functions/_shared/webhook-registry.ts +0 -129
  93. package/.framework/functions/account-nodes.ts +0 -111
  94. package/.framework/functions/admin-data.ts +0 -606
  95. package/.framework/functions/ai-agents.ts +0 -323
  96. package/.framework/functions/api-keys.ts +0 -376
  97. package/.framework/functions/apps.ts +0 -483
  98. package/.framework/functions/auth.ts +0 -196
  99. package/.framework/functions/debug-auth.ts +0 -107
  100. package/.framework/functions/embeddings.ts +0 -556
  101. package/.framework/functions/integration-routes.ts +0 -523
  102. package/.framework/functions/integrations.ts +0 -319
  103. package/.framework/functions/item-progress.ts +0 -272
  104. package/.framework/functions/logs.ts +0 -438
  105. package/.framework/functions/observability.ts +0 -275
  106. package/.framework/functions/pipeline-executions.ts +0 -494
  107. package/.framework/functions/pipelines.ts +0 -485
  108. package/.framework/functions/prompt-configs.ts +0 -339
  109. package/.framework/functions/roles.ts +0 -387
  110. package/.framework/functions/system-cron.ts +0 -742
  111. package/.framework/functions/system.ts +0 -323
  112. package/.framework/functions/tests.ts +0 -119
  113. package/.framework/functions/timers.ts +0 -357
  114. package/.framework/functions/triggers.ts +0 -563
  115. package/.framework/functions/types.ts +0 -604
  116. package/.framework/index.html +0 -16
  117. package/.framework/migrations/000_foundation.sql +0 -1266
  118. package/.framework/migrations/001_seed.sql +0 -163
  119. package/.framework/migrations/002_seed_constraints.sql +0 -19
  120. package/.framework/migrations/003_auth_user_trigger.sql +0 -67
  121. package/.framework/src/App.tsx +0 -126
  122. package/.framework/src/apps/admin/index.tsx +0 -173
  123. package/.framework/src/components/AppWrapper.tsx +0 -56
  124. package/.framework/src/components/CustomAppLoader.tsx +0 -116
  125. package/.framework/src/components/admin/AdminListPage.tsx +0 -151
  126. package/.framework/src/components/admin/AdminSidebar.tsx +0 -166
  127. package/.framework/src/components/admin/AdminStatsCard.tsx +0 -62
  128. package/.framework/src/components/admin/SortableTableHeader.tsx +0 -42
  129. package/.framework/src/components/app-shell/GenericAppShell.tsx +0 -181
  130. package/.framework/src/components/app-shell/GenericDetailPage.tsx +0 -200
  131. package/.framework/src/components/app-shell/GenericListPage.tsx +0 -116
  132. package/.framework/src/components/app-sidebar.tsx +0 -228
  133. package/.framework/src/components/auth/ProtectedRoute.tsx +0 -88
  134. package/.framework/src/components/layout/AppShell.tsx +0 -91
  135. package/.framework/src/components/layout/Header.tsx +0 -88
  136. package/.framework/src/components/layout/Layout.tsx +0 -95
  137. package/.framework/src/components/layout/Sidebar.tsx +0 -329
  138. package/.framework/src/components/runtime/DataDetailHeader.tsx +0 -77
  139. package/.framework/src/components/runtime/DataDetailPage.tsx +0 -171
  140. package/.framework/src/components/runtime/DataFilters.tsx +0 -91
  141. package/.framework/src/components/runtime/DataHeader.tsx +0 -68
  142. package/.framework/src/components/runtime/DataListPage.tsx +0 -124
  143. package/.framework/src/components/runtime/DataStats.tsx +0 -70
  144. package/.framework/src/components/runtime/DataTable.tsx +0 -174
  145. package/.framework/src/components/runtime/SchemaDetailForm.tsx +0 -134
  146. package/.framework/src/components/runtime/index.ts +0 -18
  147. package/.framework/src/components/search-form.tsx +0 -29
  148. package/.framework/src/components/shared/AgentView.tsx +0 -213
  149. package/.framework/src/components/shared/FieldRenderer.tsx +0 -478
  150. package/.framework/src/components/shared/SchemaFields.tsx +0 -226
  151. package/.framework/src/components/ui/DataTable.tsx +0 -343
  152. package/.framework/src/components/ui/Form.tsx +0 -281
  153. package/.framework/src/components/ui/ItemCard.tsx +0 -296
  154. package/.framework/src/components/ui/ItemListView.tsx +0 -308
  155. package/.framework/src/components/ui/LoadingSpinner.tsx +0 -52
  156. package/.framework/src/components/ui/Modal.tsx +0 -61
  157. package/.framework/src/components/ui/RichTextEditor.tsx +0 -210
  158. package/.framework/src/components/ui/accordion.tsx +0 -82
  159. package/.framework/src/components/ui/alert-dialog.tsx +0 -197
  160. package/.framework/src/components/ui/alert.tsx +0 -76
  161. package/.framework/src/components/ui/aspect-ratio.tsx +0 -11
  162. package/.framework/src/components/ui/avatar.tsx +0 -110
  163. package/.framework/src/components/ui/badge.tsx +0 -49
  164. package/.framework/src/components/ui/breadcrumb.tsx +0 -122
  165. package/.framework/src/components/ui/button-group.tsx +0 -83
  166. package/.framework/src/components/ui/button.tsx +0 -65
  167. package/.framework/src/components/ui/calendar.tsx +0 -222
  168. package/.framework/src/components/ui/card.tsx +0 -100
  169. package/.framework/src/components/ui/carousel.tsx +0 -240
  170. package/.framework/src/components/ui/chart.tsx +0 -368
  171. package/.framework/src/components/ui/checkbox.tsx +0 -31
  172. package/.framework/src/components/ui/collapsible.tsx +0 -33
  173. package/.framework/src/components/ui/combobox.tsx +0 -299
  174. package/.framework/src/components/ui/command.tsx +0 -193
  175. package/.framework/src/components/ui/context-menu.tsx +0 -261
  176. package/.framework/src/components/ui/dialog.tsx +0 -165
  177. package/.framework/src/components/ui/direction.tsx +0 -6
  178. package/.framework/src/components/ui/drawer.tsx +0 -132
  179. package/.framework/src/components/ui/dropdown-menu.tsx +0 -269
  180. package/.framework/src/components/ui/empty.tsx +0 -104
  181. package/.framework/src/components/ui/field.tsx +0 -238
  182. package/.framework/src/components/ui/hover-card.tsx +0 -42
  183. package/.framework/src/components/ui/input-group.tsx +0 -153
  184. package/.framework/src/components/ui/input-otp.tsx +0 -87
  185. package/.framework/src/components/ui/input.tsx +0 -19
  186. package/.framework/src/components/ui/item.tsx +0 -196
  187. package/.framework/src/components/ui/kbd.tsx +0 -26
  188. package/.framework/src/components/ui/label.tsx +0 -22
  189. package/.framework/src/components/ui/menubar.tsx +0 -277
  190. package/.framework/src/components/ui/native-select.tsx +0 -61
  191. package/.framework/src/components/ui/navigation-menu.tsx +0 -164
  192. package/.framework/src/components/ui/pagination.tsx +0 -129
  193. package/.framework/src/components/ui/popover.tsx +0 -87
  194. package/.framework/src/components/ui/progress.tsx +0 -31
  195. package/.framework/src/components/ui/radio-group.tsx +0 -42
  196. package/.framework/src/components/ui/resizable.tsx +0 -50
  197. package/.framework/src/components/ui/scroll-area.tsx +0 -53
  198. package/.framework/src/components/ui/select.tsx +0 -195
  199. package/.framework/src/components/ui/separator.tsx +0 -26
  200. package/.framework/src/components/ui/sheet.tsx +0 -145
  201. package/.framework/src/components/ui/sidebar.tsx +0 -706
  202. package/.framework/src/components/ui/skeleton.tsx +0 -13
  203. package/.framework/src/components/ui/slider.tsx +0 -59
  204. package/.framework/src/components/ui/sonner.tsx +0 -47
  205. package/.framework/src/components/ui/spinner.tsx +0 -10
  206. package/.framework/src/components/ui/switch.tsx +0 -33
  207. package/.framework/src/components/ui/table-primitives.tsx +0 -141
  208. package/.framework/src/components/ui/table.tsx +0 -114
  209. package/.framework/src/components/ui/tabs.tsx +0 -90
  210. package/.framework/src/components/ui/textarea.tsx +0 -18
  211. package/.framework/src/components/ui/toggle-group.tsx +0 -89
  212. package/.framework/src/components/ui/toggle.tsx +0 -45
  213. package/.framework/src/components/ui/tooltip.tsx +0 -57
  214. package/.framework/src/contexts/AppContext.tsx +0 -133
  215. package/.framework/src/contexts/AuthContext.tsx +0 -371
  216. package/.framework/src/hooks/use-mobile.ts +0 -19
  217. package/.framework/src/hooks/useApi.ts +0 -526
  218. package/.framework/src/hooks/useApps.ts +0 -114
  219. package/.framework/src/hooks/useEntityList.ts +0 -190
  220. package/.framework/src/hooks/useEntityRecord.ts +0 -308
  221. package/.framework/src/hooks/useForm.ts +0 -307
  222. package/.framework/src/hooks/useListSchema.ts +0 -264
  223. package/.framework/src/hooks/useSchemaRecord.ts +0 -223
  224. package/.framework/src/index.css +0 -128
  225. package/.framework/src/lib/api.ts +0 -156
  226. package/.framework/src/lib/supabase.ts +0 -94
  227. package/.framework/src/lib/utils.ts +0 -317
  228. package/.framework/src/main.tsx +0 -27
  229. package/.framework/src/pages/DashboardPage.tsx +0 -181
  230. package/.framework/src/pages/NotFoundPage.tsx +0 -39
  231. package/.framework/src/pages/admin/AIAgentDetailPage.tsx +0 -161
  232. package/.framework/src/pages/admin/AIAgentsPage.tsx +0 -318
  233. package/.framework/src/pages/admin/APIKeyDetailPage.tsx +0 -199
  234. package/.framework/src/pages/admin/APIKeysPage.tsx +0 -303
  235. package/.framework/src/pages/admin/AlertsConfigPage.tsx +0 -523
  236. package/.framework/src/pages/admin/AppDetailPage.tsx +0 -493
  237. package/.framework/src/pages/admin/AppsPage.tsx +0 -355
  238. package/.framework/src/pages/admin/DesignedPage.tsx +0 -491
  239. package/.framework/src/pages/admin/EmbeddingDetailPage.tsx +0 -534
  240. package/.framework/src/pages/admin/EmbeddingsPage.tsx +0 -424
  241. package/.framework/src/pages/admin/ExtendedShadcnTestPage.tsx +0 -176
  242. package/.framework/src/pages/admin/IncrementalShadcnTestPage.tsx +0 -109
  243. package/.framework/src/pages/admin/IntegratedDashboard.tsx +0 -402
  244. package/.framework/src/pages/admin/IntegrationDetailPage.tsx +0 -187
  245. package/.framework/src/pages/admin/IntegrationsPage.tsx +0 -301
  246. package/.framework/src/pages/admin/LogsPage.tsx +0 -283
  247. package/.framework/src/pages/admin/MinimalShadcnTestPage.tsx +0 -85
  248. package/.framework/src/pages/admin/ObservabilityDashboard.tsx +0 -470
  249. package/.framework/src/pages/admin/PipelineDetailPage.tsx +0 -183
  250. package/.framework/src/pages/admin/PipelineExecutionsPage.tsx +0 -279
  251. package/.framework/src/pages/admin/PipelinesPage.tsx +0 -390
  252. package/.framework/src/pages/admin/PromptConfigDetailPage.tsx +0 -299
  253. package/.framework/src/pages/admin/PromptConfigsPage.tsx +0 -292
  254. package/.framework/src/pages/admin/ProperlyDesignedPage.tsx +0 -434
  255. package/.framework/src/pages/admin/RoleDetailPage.tsx +0 -273
  256. package/.framework/src/pages/admin/RolesPage.tsx +0 -292
  257. package/.framework/src/pages/admin/SelectTestPage.tsx +0 -61
  258. package/.framework/src/pages/admin/ShadcnTestPage.tsx +0 -588
  259. package/.framework/src/pages/admin/SimpleDashboard.tsx +0 -387
  260. package/.framework/src/pages/admin/TestRunDetailPage.tsx +0 -172
  261. package/.framework/src/pages/admin/TestingDashboard.tsx +0 -257
  262. package/.framework/src/pages/admin/TimerDetailPage.tsx +0 -151
  263. package/.framework/src/pages/admin/TimersPage.tsx +0 -376
  264. package/.framework/src/pages/admin/TriggerDetailPage.tsx +0 -149
  265. package/.framework/src/pages/admin/TriggersPage.tsx +0 -381
  266. package/.framework/src/pages/admin/TypeDetailPage.tsx +0 -694
  267. package/.framework/src/pages/admin/TypesPage.tsx +0 -295
  268. package/.framework/src/pages/auth/LoginPage.tsx +0 -187
  269. package/.framework/src/pages/auth/RegisterPage.tsx +0 -163
  270. package/.framework/src/pages/spine-framework/APIPage.tsx +0 -17
  271. package/.framework/src/pages/spine-framework/CLIPage.tsx +0 -25
  272. package/.framework/src/types/auth.ts +0 -125
  273. package/.framework/src/types/types.ts +0 -407
  274. package/STRUCTURE.md +0 -150
  275. package/bin/spine-framework.cjs +0 -62
  276. package/bin/welcome.cjs +0 -45
  277. package/bin/ws-shim.cjs +0 -8
  278. package/bin/ws-shim.ts +0 -10
  279. package/config/components.json +0 -25
  280. package/config/deno.lock +0 -108
  281. package/config/package-lock.json +0 -17183
  282. package/config/postcss.config.cjs +0 -10
  283. package/config/tailwind.config.cjs +0 -78
  284. package/config/tsconfig.build.json +0 -32
  285. package/config/tsconfig.cli.json +0 -18
  286. package/config/tsconfig.json +0 -41
  287. package/config/tsconfig.node.json +0 -17
  288. package/config/tsconfig.node.tsbuildinfo +0 -1
  289. package/config/tsconfig.tsbuildinfo +0 -1
  290. package/config/typedoc.json +0 -16
  291. package/config/vite.config.d.ts +0 -2
  292. package/config/vite.config.ts +0 -72
  293. package/dist/cli/commands/agents.d.ts +0 -39
  294. package/dist/cli/commands/agents.d.ts.map +0 -1
  295. package/dist/cli/commands/auth.d.ts +0 -36
  296. package/dist/cli/commands/auth.d.ts.map +0 -1
  297. package/dist/cli/commands/create-app.d.ts +0 -23
  298. package/dist/cli/commands/create-app.d.ts.map +0 -1
  299. package/dist/cli/commands/dev.d.ts +0 -24
  300. package/dist/cli/commands/dev.d.ts.map +0 -1
  301. package/dist/cli/commands/doctor.d.ts +0 -42
  302. package/dist/cli/commands/doctor.d.ts.map +0 -1
  303. package/dist/cli/commands/generate.d.ts +0 -36
  304. package/dist/cli/commands/generate.d.ts.map +0 -1
  305. package/dist/cli/commands/init.d.ts +0 -20
  306. package/dist/cli/commands/init.d.ts.map +0 -1
  307. package/dist/cli/commands/install-app.d.ts +0 -30
  308. package/dist/cli/commands/install-app.d.ts.map +0 -1
  309. package/dist/cli/commands/items.d.ts +0 -45
  310. package/dist/cli/commands/items.d.ts.map +0 -1
  311. package/dist/cli/commands/migrate.d.ts +0 -21
  312. package/dist/cli/commands/migrate.d.ts.map +0 -1
  313. package/dist/cli/commands/migrations.d.ts +0 -41
  314. package/dist/cli/commands/migrations.d.ts.map +0 -1
  315. package/dist/cli/commands/pipelines.d.ts +0 -40
  316. package/dist/cli/commands/pipelines.d.ts.map +0 -1
  317. package/dist/cli/commands/status.d.ts +0 -23
  318. package/dist/cli/commands/status.d.ts.map +0 -1
  319. package/dist/cli/commands/system.d.ts +0 -29
  320. package/dist/cli/commands/system.d.ts.map +0 -1
  321. package/dist/cli/commands/test.d.ts +0 -46
  322. package/dist/cli/commands/test.d.ts.map +0 -1
  323. package/dist/cli/commands/uninstall-app.d.ts +0 -23
  324. package/dist/cli/commands/uninstall-app.d.ts.map +0 -1
  325. package/dist/cli/context.d.ts +0 -88
  326. package/dist/cli/context.d.ts.map +0 -1
  327. package/dist/cli/env-loader.d.ts +0 -14
  328. package/dist/cli/env-loader.d.ts.map +0 -1
  329. package/dist/cli/index.d.ts +0 -41
  330. package/dist/cli/index.d.ts.map +0 -1
  331. package/dist/functions/_shared/agent-runner.d.ts +0 -156
  332. package/dist/functions/_shared/agent-runner.d.ts.map +0 -1
  333. package/dist/functions/_shared/app-manifest.d.ts +0 -68
  334. package/dist/functions/_shared/app-manifest.d.ts.map +0 -1
  335. package/dist/functions/_shared/audit.d.ts +0 -91
  336. package/dist/functions/_shared/audit.d.ts.map +0 -1
  337. package/dist/functions/_shared/db.d.ts +0 -125
  338. package/dist/functions/_shared/db.d.ts.map +0 -1
  339. package/dist/functions/_shared/index.d.ts +0 -299
  340. package/dist/functions/_shared/index.d.ts.map +0 -1
  341. package/dist/functions/_shared/middleware.d.ts +0 -315
  342. package/dist/functions/_shared/middleware.d.ts.map +0 -1
  343. package/dist/functions/_shared/permissions.d.ts +0 -626
  344. package/dist/functions/_shared/permissions.d.ts.map +0 -1
  345. package/dist/functions/_shared/pipeline-runner.d.ts +0 -124
  346. package/dist/functions/_shared/pipeline-runner.d.ts.map +0 -1
  347. package/dist/functions/_shared/principal.d.ts +0 -284
  348. package/dist/functions/_shared/principal.d.ts.map +0 -1
  349. package/dist/functions/_shared/resolve-ids.d.ts +0 -10
  350. package/dist/functions/_shared/resolve-ids.d.ts.map +0 -1
  351. package/dist/functions/_shared/schema-utils.d.ts +0 -181
  352. package/dist/functions/_shared/schema-utils.d.ts.map +0 -1
  353. package/dist/functions/_shared/testing.d.ts +0 -172
  354. package/dist/functions/_shared/testing.d.ts.map +0 -1
  355. package/dist/functions/_shared/trigger-engine.d.ts +0 -140
  356. package/dist/functions/_shared/trigger-engine.d.ts.map +0 -1
  357. package/dist/functions/_shared/webhook-registration.d.ts +0 -81
  358. package/dist/functions/_shared/webhook-registration.d.ts.map +0 -1
  359. package/dist/functions/_shared/webhook-registry.d.ts +0 -57
  360. package/dist/functions/_shared/webhook-registry.d.ts.map +0 -1
  361. package/dist/functions/account-nodes.d.ts +0 -48
  362. package/dist/functions/account-nodes.d.ts.map +0 -1
  363. package/dist/functions/admin-data.d.ts +0 -178
  364. package/dist/functions/admin-data.d.ts.map +0 -1
  365. package/dist/functions/ai-agents.d.ts +0 -125
  366. package/dist/functions/ai-agents.d.ts.map +0 -1
  367. package/dist/functions/api-keys.d.ts +0 -140
  368. package/dist/functions/api-keys.d.ts.map +0 -1
  369. package/dist/functions/apps.d.ts +0 -163
  370. package/dist/functions/apps.d.ts.map +0 -1
  371. package/dist/functions/auth.d.ts +0 -74
  372. package/dist/functions/auth.d.ts.map +0 -1
  373. package/dist/functions/debug-auth.d.ts +0 -33
  374. package/dist/functions/debug-auth.d.ts.map +0 -1
  375. package/dist/functions/embeddings.d.ts +0 -205
  376. package/dist/functions/embeddings.d.ts.map +0 -1
  377. package/dist/functions/integration-routes.d.ts +0 -45
  378. package/dist/functions/integration-routes.d.ts.map +0 -1
  379. package/dist/functions/integrations.d.ts +0 -124
  380. package/dist/functions/integrations.d.ts.map +0 -1
  381. package/dist/functions/item-progress.d.ts +0 -41
  382. package/dist/functions/item-progress.d.ts.map +0 -1
  383. package/dist/functions/logs.d.ts +0 -162
  384. package/dist/functions/logs.d.ts.map +0 -1
  385. package/dist/functions/observability.d.ts +0 -123
  386. package/dist/functions/observability.d.ts.map +0 -1
  387. package/dist/functions/pipeline-executions.d.ts +0 -190
  388. package/dist/functions/pipeline-executions.d.ts.map +0 -1
  389. package/dist/functions/pipelines.d.ts +0 -171
  390. package/dist/functions/pipelines.d.ts.map +0 -1
  391. package/dist/functions/prompt-configs.d.ts +0 -125
  392. package/dist/functions/prompt-configs.d.ts.map +0 -1
  393. package/dist/functions/roles.d.ts +0 -118
  394. package/dist/functions/roles.d.ts.map +0 -1
  395. package/dist/functions/system-cron.d.ts +0 -65
  396. package/dist/functions/system-cron.d.ts.map +0 -1
  397. package/dist/functions/system.d.ts +0 -29
  398. package/dist/functions/system.d.ts.map +0 -1
  399. package/dist/functions/tests.d.ts +0 -28
  400. package/dist/functions/tests.d.ts.map +0 -1
  401. package/dist/functions/timers.d.ts +0 -139
  402. package/dist/functions/timers.d.ts.map +0 -1
  403. package/dist/functions/triggers.d.ts +0 -203
  404. package/dist/functions/triggers.d.ts.map +0 -1
  405. package/dist/functions/types.d.ts +0 -151
  406. package/dist/functions/types.d.ts.map +0 -1
  407. package/dist/src/types/types.d.ts +0 -364
  408. package/dist/src/types/types.d.ts.map +0 -1
  409. package/index.html +0 -13
  410. package/netlify.toml +0 -36
  411. package/package-project.json +0 -64
  412. package/scripts/app-install-cli.ts +0 -286
  413. package/scripts/assemble-frontend.sh +0 -79
  414. package/scripts/assemble-functions.sh +0 -62
  415. package/scripts/assemble.sh +0 -41
  416. package/scripts/boundary-check.sh +0 -106
  417. package/scripts/build-manifest.sh +0 -80
  418. package/scripts/check-core-integrity.sh +0 -82
  419. package/scripts/ingest-chunks.cjs +0 -202
  420. package/scripts/kb-chunk-parser.cjs +0 -312
  421. package/scripts/kb-chunk-parser.ts +0 -330
  422. package/scripts/load-test-app-install.ts +0 -484
  423. package/scripts/netlify-dev-wrapper.sh +0 -22
  424. package/scripts/verify-integrity.sh +0 -69
  425. package/vitest.config.ts +0 -45
@@ -1,172 +0,0 @@
1
- /**
2
- * @module testing
3
- * @audience custom-developer
4
- * @layer shared-util
5
- * @stability evolving
6
- *
7
- * Testing utilities for custom code developers.
8
- * Use these to test your custom functions without full deployment.
9
- *
10
- * **Usage in custom function tests:**
11
- * ```ts
12
- * import { makeTestContext, mockPrincipal, cleanup } from '@core/testing'
13
- *
14
- * describe('My Custom Handler', () => {
15
- * it('should process items', async () => {
16
- * const ctx = makeTestContext({
17
- * principal: mockPrincipal({ roles: ['member'] }),
18
- * accountId: 'test-account'
19
- * })
20
- *
21
- * const result = await myHandler(mockEvent, ctx)
22
- * expect(result.status).toBe('success')
23
- *
24
- * cleanup()
25
- * })
26
- * })
27
- * ```
28
- *
29
- * @seeAlso .framework/tests/unit/core-isolation.test.ts (examples)
30
- */
31
- import { adminDb } from './db';
32
- export interface TestContext {
33
- db: typeof adminDb;
34
- principal: TestPrincipal;
35
- logger: TestLogger;
36
- accountId: string;
37
- }
38
- export interface TestPrincipal {
39
- id: string;
40
- account_id: string;
41
- roles: string[];
42
- permissions: Record<string, any>;
43
- email?: string;
44
- }
45
- export interface TestLogger {
46
- info: (msg: string, meta?: any) => void;
47
- warn: (msg: string, meta?: any) => void;
48
- error: (msg: string, meta?: any) => void;
49
- debug: (msg: string, meta?: any) => void;
50
- }
51
- /**
52
- * Creates a mock principal for testing.
53
- *
54
- * @param overrides - Override default principal properties
55
- * @returns Mock principal object
56
- *
57
- * @example
58
- * ```ts
59
- * const admin = mockPrincipal({
60
- * roles: ['system_admin'],
61
- * permissions: { all: true }
62
- * })
63
- * ```
64
- */
65
- export declare function mockPrincipal(overrides?: Partial<TestPrincipal>): TestPrincipal;
66
- /**
67
- * Creates a mock logger that captures logs for assertions.
68
- *
69
- * @returns TestLogger with log capture
70
- *
71
- * @example
72
- * ```ts
73
- * const logger = mockLogger()
74
- * await myFunction(logger)
75
- * expect(logger.getLogs()).toContain('Processing started')
76
- * ```
77
- */
78
- export declare function mockLogger(): TestLogger & {
79
- getLogs: () => string[];
80
- };
81
- /**
82
- * Creates a test context for handler testing.
83
- *
84
- * @param options - Test context configuration
85
- * @returns TestContext ready for handler
86
- *
87
- * @example
88
- * ```ts
89
- * const ctx = makeTestContext({
90
- * principal: mockPrincipal({ roles: ['operator'] }),
91
- * accountId: 'my-account'
92
- * })
93
- *
94
- * const result = await handler(mockEvent, ctx)
95
- * ```
96
- */
97
- export declare function makeTestContext(options?: {
98
- principal?: TestPrincipal;
99
- accountId?: string;
100
- logger?: TestLogger;
101
- }): TestContext;
102
- /**
103
- * Creates a mock API Gateway event.
104
- *
105
- * @param overrides - Override default event properties
106
- * @returns Mock event object
107
- *
108
- * @example
109
- * ```ts
110
- * const event = mockEvent({
111
- * httpMethod: 'POST',
112
- * body: JSON.stringify({ item_id: '123' })
113
- * })
114
- * ```
115
- */
116
- export declare function mockEvent(overrides?: any): any;
117
- /**
118
- * Creates a mock Netlify function context.
119
- *
120
- * @returns Mock context object
121
- */
122
- export declare function mockNetlifyContext(): any;
123
- /**
124
- * Cleanup function for tests.
125
- * Clears caches and resets state.
126
- */
127
- export declare function cleanup(): void;
128
- /**
129
- * Setup helper for test files.
130
- * Returns utilities commonly needed in tests.
131
- *
132
- * @example
133
- * ```ts
134
- * import { setupTests } from '@core/testing'
135
- *
136
- * const { makeTestContext, mockPrincipal, cleanup } = setupTests()
137
- *
138
- * describe('My Tests', () => {
139
- * afterEach(cleanup)
140
- * // ... tests
141
- * })
142
- * ```
143
- */
144
- export declare function setupTests(): {
145
- makeTestContext: typeof makeTestContext;
146
- mockPrincipal: typeof mockPrincipal;
147
- mockLogger: typeof mockLogger;
148
- mockEvent: typeof mockEvent;
149
- mockNetlifyContext: typeof mockNetlifyContext;
150
- cleanup: typeof cleanup;
151
- };
152
- /**
153
- * Asserts that a handler response matches expected structure.
154
- *
155
- * @param response - Handler response
156
- * @param expectedStatus - Expected status code
157
- */
158
- export declare function expectSuccessResponse(response: {
159
- statusCode?: number;
160
- body?: string;
161
- }, expectedStatus?: number): void;
162
- /**
163
- * Asserts that a handler returned an error.
164
- *
165
- * @param response - Handler response
166
- * @param expectedStatus - Expected error status code
167
- */
168
- export declare function expectErrorResponse(response: {
169
- statusCode?: number;
170
- body?: string;
171
- }, expectedStatus?: number): void;
172
- //# sourceMappingURL=testing.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../.framework/functions/_shared/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE9B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,OAAO,CAAA;IAClB,SAAS,EAAE,aAAa,CAAA;IACxB,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;IACvC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;IACvC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;IACxC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;CACzC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,SAAS,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa,CASnF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,IAAI,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,MAAM,EAAE,CAAA;CAAE,CAsBrE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE;IACvC,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,UAAU,CAAA;CACf,GAAG,WAAW,CAOnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,SAAS,GAAE,GAAQ,GAAG,GAAG,CASlD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,GAAG,CASxC;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAI9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU;;;;;;;EASzB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAChD,cAAc,GAAE,MAAY,GAC3B,IAAI,CAON;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAChD,cAAc,GAAE,MAAY,GAC3B,IAAI,CAON"}
@@ -1,140 +0,0 @@
1
- /**
2
- * @module trigger-engine
3
- * @audience both
4
- * @layer shared-core
5
- * @stability stable
6
- *
7
- * Event-driven trigger dispatch system. API handlers call `fire*Triggers` after
8
- * a successful write to check whether any active triggers should fire. Matching
9
- * triggers cause `runPipeline` to be invoked with structured `triggerData`.
10
- *
11
- * Public surface:
12
- * - `checkAndFireTriggers` — full trigger evaluation and firing loop
13
- * - `fireCreateTriggers` — convenience wrapper for `*_created` events
14
- * - `fireUpdateTriggers` — convenience wrapper for `*_updated` events
15
- * - `fireDeleteTriggers` — convenience wrapper for `*_deleted` events
16
- *
17
- * Trigger condition evaluation (in order, all must pass):
18
- * 1. `config.entity_type` — exact match on entityType param
19
- * 2. `config.type_slug` — match on `entityData.type_slug` (items only)
20
- * 3. `config.filters` — field-level predicates with operators
21
- * (`$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, `$exists`)
22
- *
23
- * INVARIANT: trigger evaluation and firing errors are caught per-trigger —
24
- * a single failing trigger never prevents other triggers from firing.
25
- * INVARIANT: `checkAndFireTriggers` never throws — all errors are caught
26
- * and logged. Callers do not need to wrap in try/catch.
27
- * INVARIANT: `adminDb` (service role) is used for trigger lookups and stats
28
- * updates; `runPipeline` then uses the passed `ctx` for stage execution.
29
- *
30
- * @seeAlso pipeline-runner.ts (runPipeline — called when a trigger fires)
31
- * @seeAlso audit.ts (emitAudit for trigger.fired / trigger.failed)
32
- * @seeAlso index.ts (fire*Triggers re-exported for v2-custom/ and CLI)
33
- */
34
- import { CoreContext } from './middleware';
35
- /**
36
- * All entity lifecycle event types that triggers can subscribe to.
37
- *
38
- * Format: `<entity>_<lifecycle>` where entity is one of:
39
- * `item | account | person | thread | message | attachment | link`
40
- * and lifecycle is `created | updated | deleted`.
41
- *
42
- * @calledBy checkAndFireTriggers, fireCreateTriggers, fireUpdateTriggers,
43
- * fireDeleteTriggers, all API handlers that write to these entity tables
44
- */
45
- export type EventType = 'item_created' | 'item_updated' | 'item_deleted' | 'account_created' | 'account_updated' | 'account_deleted' | 'person_created' | 'person_updated' | 'person_deleted' | 'thread_created' | 'thread_updated' | 'thread_deleted' | 'message_created' | 'message_updated' | 'message_deleted' | 'attachment_created' | 'attachment_updated' | 'attachment_deleted' | 'link_created' | 'link_updated' | 'link_deleted';
46
- /**
47
- * Queries active triggers for `eventType`, evaluates each against the entity
48
- * data, and fires the associated pipeline for every matching trigger.
49
- *
50
- * Execution per trigger:
51
- * 1. `evaluateTriggerConditions` — all conditions must pass
52
- * 2. `runPipeline(trigger.pipeline_id, triggerData, ctx)` — fire pipeline
53
- * 3. Update `triggers.last_triggered` and increment `trigger_count` via RPC
54
- * 4. Emit `trigger.fired` audit log (or `trigger.failed` on error)
55
- *
56
- * `triggerData` passed to the pipeline:
57
- * ```json
58
- * {
59
- * "event": "item_updated",
60
- * "entity": { "type": "item", "id": "<uuid>", "data": {...} },
61
- * "trigger": { "id": "<uuid>", "name": "My Trigger" },
62
- * "fired_at": "2024-01-15T10:00:00.000Z"
63
- * }
64
- * ```
65
- *
66
- * @param eventType - The lifecycle event (e.g. 'item_updated')
67
- * @param entityType - The entity table name (e.g. 'item', 'person')
68
- * @param entityId - UUID of the entity that changed
69
- * @param entityData - Full record data for condition evaluation
70
- * @param ctx - CoreContext with requestId, accountId, and principal
71
- * @returns Promise<void> — always resolves; never throws
72
- * @throws never — all errors are caught per-trigger and logged
73
- * @inputSpec eventType: EventType — must be one of the 21 defined event types
74
- * @inputSpec entityId: string — UUID of the changed entity
75
- * @inputSpec entityData: any — full record (used for condition evaluation)
76
- * @outputSpec void
77
- * @sideEffects DB read: triggers table
78
- * @sideEffects DB write (per matching trigger): triggers.last_triggered, trigger_count
79
- * @sideEffects Calls runPipeline (per matching trigger) — which writes pipeline_executions
80
- * @sideEffects DB write: emitAudit (trigger.fired or trigger.failed per trigger)
81
- * @calledBy All API handlers after successful create/update/delete writes
82
- * @calledBy fireCreateTriggers, fireUpdateTriggers, fireDeleteTriggers
83
- * @calls evaluateTriggerConditions, runPipeline, emitAudit
84
- * @testUnit tests/unit/trigger-engine.test.ts
85
- * @testIntegration tests/integration/trigger-engine.test.ts
86
- *
87
- * @example
88
- * ```ts
89
- * // In an API handler after a successful item update:
90
- * await fireUpdateTriggers('item', updatedItem.id, updatedItem, ctx)
91
- * ```
92
- */
93
- export declare function checkAndFireTriggers(eventType: EventType, entityType: string, entityId: string, entityData: any, ctx: CoreContext): Promise<void>;
94
- /**
95
- * Fires `<entityType>_created` triggers. Thin wrapper around
96
- * `checkAndFireTriggers` that constructs the correct EventType.
97
- *
98
- * @param entityType - Entity table name (e.g. 'item', 'person')
99
- * @param entityId - UUID of the newly created entity
100
- * @param entityData - The created record (for condition evaluation)
101
- * @param ctx - CoreContext
102
- * @returns Promise<void> — always resolves
103
- * @throws never
104
- * @sideEffects same as checkAndFireTriggers
105
- * @calledBy Any API handler's create path (e.g. items.ts, people.ts)
106
- * @calls checkAndFireTriggers
107
- * @testUnit tests/unit/trigger-engine.test.ts — 'fireCreateTriggers'
108
- */
109
- export declare function fireCreateTriggers(entityType: string, entityId: string, entityData: any, ctx: CoreContext): Promise<void>;
110
- /**
111
- * Fires `<entityType>_updated` triggers. Thin wrapper around
112
- * `checkAndFireTriggers` that constructs the correct EventType.
113
- *
114
- * @param entityType - Entity table name (e.g. 'item', 'person')
115
- * @param entityId - UUID of the updated entity
116
- * @param entityData - The updated record (for condition evaluation)
117
- * @param ctx - CoreContext
118
- * @returns Promise<void> — always resolves
119
- * @throws never
120
- * @sideEffects same as checkAndFireTriggers
121
- * @calledBy Any API handler's update path
122
- * @calls checkAndFireTriggers
123
- */
124
- export declare function fireUpdateTriggers(entityType: string, entityId: string, entityData: any, ctx: CoreContext): Promise<void>;
125
- /**
126
- * Fires `<entityType>_deleted` triggers. Thin wrapper around
127
- * `checkAndFireTriggers` that constructs the correct EventType.
128
- *
129
- * @param entityType - Entity table name (e.g. 'item', 'person')
130
- * @param entityId - UUID of the deleted entity
131
- * @param entityData - The record snapshot before deletion (for condition evaluation)
132
- * @param ctx - CoreContext
133
- * @returns Promise<void> — always resolves
134
- * @throws never
135
- * @sideEffects same as checkAndFireTriggers
136
- * @calledBy Any API handler's delete path
137
- * @calls checkAndFireTriggers
138
- */
139
- export declare function fireDeleteTriggers(entityType: string, entityId: string, entityData: any, ctx: CoreContext): Promise<void>;
140
- //# sourceMappingURL=trigger-engine.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"trigger-engine.d.ts","sourceRoot":"","sources":["../../../.framework/functions/_shared/trigger-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAO1C;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GACjB,cAAc,GAAG,cAAc,GAAG,cAAc,GAChD,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,GACzD,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,GACtD,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,GACtD,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,GACzD,oBAAoB,GAAG,oBAAoB,GAAG,oBAAoB,GAClE,cAAc,GAAG,cAAc,GAAG,cAAc,CAAA;AA0BpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,GAAG,EACf,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAgFf;AAwID;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,GAAG,EACf,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,GAAG,EACf,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,GAAG,EACf,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAGf"}
@@ -1,81 +0,0 @@
1
- /**
2
- * @module webhook-registration
3
- * @audience custom-developer
4
- * @layer shared-util
5
- * @stability stable
6
- *
7
- * Helper utilities for custom webhook handlers to self-register.
8
- * Use this in your custom Netlify functions to register as webhook handlers.
9
- *
10
- * **Usage in a custom function:**
11
- * ```ts
12
- * import { createHandler } from '../_shared/middleware'
13
- * import { registerWebhookHandler } from '../_shared/webhook-registration'
14
- * import { adminDb } from '../_shared/db'
15
- *
16
- * export const handler = createHandler(async (event, ctx) => {
17
- * // Your webhook logic here
18
- * })
19
- *
20
- * // Self-register on first load (idempotent)
21
- * registerWebhookHandler({
22
- * name: 'my-custom-handler',
23
- * functionName: 'custom_my-webhook',
24
- * description: 'Handles my custom integration events',
25
- * events: ['user.created', 'item.updated'],
26
- * db: adminDb
27
- * }).catch(console.error)
28
- * ```
29
- *
30
- * @seeAlso webhook-registry.ts (core lookup service)
31
- * @seeAlso 014_webhook_registry.sql (database table)
32
- */
33
- import { adminDb } from './db';
34
- export interface WebhookHandlerRegistration {
35
- /** Unique handler identifier (e.g., 'cortex-handler') */
36
- name: string;
37
- /** Netlify function name (e.g., 'custom_cortex-handler') */
38
- functionName: string;
39
- /** Human-readable description */
40
- description?: string;
41
- /** Events this handler subscribes to */
42
- events?: string[];
43
- /** Account ID (null for system handlers) */
44
- accountId?: string | null;
45
- /** Database client (defaults to adminDb) */
46
- db?: typeof adminDb;
47
- }
48
- /**
49
- * Registers a webhook handler in the database registry.
50
- * Idempotent - safe to call multiple times.
51
- *
52
- * @param config - Handler registration configuration
53
- * @returns Promise that resolves when registration completes
54
- *
55
- * @example
56
- * ```ts
57
- * await registerWebhookHandler({
58
- * name: 'slack-webhook',
59
- * functionName: 'custom_slack-integration',
60
- * description: 'Posts notifications to Slack',
61
- * events: ['item.created', 'item.updated']
62
- * })
63
- * ```
64
- */
65
- export declare function registerWebhookHandler(config: WebhookHandlerRegistration): Promise<void>;
66
- /**
67
- * Deregisters a webhook handler (soft delete).
68
- *
69
- * @param name - Handler identifier to deregister
70
- * @param db - Optional database client
71
- */
72
- export declare function deregisterWebhookHandler(name: string, db?: typeof adminDb): Promise<void>;
73
- /**
74
- * Checks if a handler is registered.
75
- *
76
- * @param name - Handler identifier to check
77
- * @param db - Optional database client
78
- * @returns True if handler exists and is active
79
- */
80
- export declare function isHandlerRegistered(name: string, db?: typeof adminDb): Promise<boolean>;
81
- //# sourceMappingURL=webhook-registration.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"webhook-registration.d.ts","sourceRoot":"","sources":["../../../.framework/functions/_shared/webhook-registration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE9B,MAAM,WAAW,0BAA0B;IACzC,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IAEZ,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAA;IAEpB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IAEjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEzB,4CAA4C;IAC5C,EAAE,CAAC,EAAE,OAAO,OAAO,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,EAAE,GAAE,OAAO,OAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,EAAE,GAAE,OAAO,OAAiB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAoBlB"}
@@ -1,57 +0,0 @@
1
- /**
2
- * @module webhook-registry
3
- * @audience core-contributor
4
- * @layer shared-service
5
- * @stability stable
6
- *
7
- * Dynamic webhook handler registry for runtime handler resolution.
8
- * Replaces static imports with database-driven handler lookups.
9
- *
10
- * **Pattern:**
11
- * 1. Custom handlers self-register via `integrations` table or `webhook_handlers` table
12
- * 2. Core looks up handler by name at runtime
13
- * 3. Dynamic import loads the handler function
14
- *
15
- * **Benefits:**
16
- * - Core has zero hardcoded dependencies on custom handlers
17
- * - Handlers can be added/removed without core code changes
18
- * - Multi-tenancy: different tenants can have different handlers
19
- *
20
- * @seeAlso integration-routes.ts (uses this registry)
21
- * @seeAlso webhook-registration.ts (self-registration helper for custom handlers)
22
- */
23
- /**
24
- * Looks up a webhook handler in the database registry.
25
- * Returns the function name to dynamically import.
26
- *
27
- * @param handlerName - The handler identifier (e.g., "cortex-handler")
28
- * @returns Handler metadata or null if not found
29
- */
30
- export declare function lookupHandler(handlerName: string): Promise<{
31
- functionName: string;
32
- } | null>;
33
- /**
34
- * Loads a webhook handler function dynamically.
35
- * Uses dynamic import to avoid static dependencies.
36
- *
37
- * @param functionName - The Netlify function name (e.g., "custom_cortex-handler")
38
- * @returns The handler function or null if not found
39
- */
40
- export declare function loadHandler(functionName: string): Promise<Function | null>;
41
- /**
42
- * Resolves a webhook handler by name.
43
- * Combines lookup + load for convenience.
44
- *
45
- * @param handlerName - The handler identifier
46
- * @returns The handler function or null
47
- */
48
- export declare function resolveHandler(handlerName: string): Promise<Function | null>;
49
- /**
50
- * Clears the handler cache. Useful for testing or after deployments.
51
- */
52
- export declare function clearHandlerCache(): void;
53
- /**
54
- * Lists all registered handlers (for debugging/admin).
55
- */
56
- export declare function listRegisteredHandlers(): Promise<string[]>;
57
- //# sourceMappingURL=webhook-registry.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"webhook-registry.d.ts","sourceRoot":"","sources":["../../../.framework/functions/_shared/webhook-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA2BjG;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAmBhF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAKlF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAYhE"}
@@ -1,48 +0,0 @@
1
- /**
2
- * @module account-nodes
3
- * @audience core-contributor
4
- * @layer api-handler
5
- * @stability stable
6
- *
7
- * Account hierarchy traversal endpoint. Given a single `node_id`, returns
8
- * the target account record plus three relational views:
9
- * - **ancestors** — all nodes from root to this node (via `get_account_ancestors` RPC)
10
- * - **children** — direct active children ordered by `display_name`
11
- * - **descendants** — all active nodes in the subtree (via `get_account_descendants` RPC)
12
- *
13
- * **Routed by:** `GET /.netlify/functions/account-nodes`
14
- *
15
- * **Authorization:** Uses `ctx.db` (RLS-scoped). Only accounts visible to
16
- * the authenticated principal are returned. Inactive accounts are excluded
17
- * (`is_active = true` filter on node + children queries).
18
- *
19
- * **Response shape:**
20
- * ```ts
21
- * {
22
- * node: Account & { type: TypeRecord }
23
- * ancestors: AccountAncestorRow[]
24
- * children: Array<Account & { type: TypeRecord }>
25
- * descendants: AccountDescendantRow[]
26
- * }
27
- * ```
28
- *
29
- * @seeAlso auth.ts (context handler also calls get_account_hierarchy RPC)
30
- * @seeAlso accounts.ts (CRUD; creates the account nodes)
31
- * @seeAlso _shared/db.ts (get_account_ancestors / get_account_descendants RPCs)
32
- */
33
- /**
34
- * @chunk-id ACCOUNT_NODES_HANDLER_1_0_0
35
- * @version 1.0.0
36
- * @hash 0778bcec10cfbe1a79177e4352706270194cf80cd0baa39c6ed615c73c7c7695
37
- * @macro Account Hierarchy Handler
38
- * @micro Returns account node with ancestors, children, and descendants
39
- * @inputs ctx: CoreContext — Request context with principal and database
40
- * @inputs body: any — Request body (unused for GET)
41
- * @outputs {node, ancestors, children, descendants} — Complete hierarchy data
42
- * @depends-on [createHandler, get_account_ancestors, get_account_descendants]
43
- * @depended-by [Netlify function routing]
44
- * @side-effects [DB queries, RPC calls]
45
- * @tags account, hierarchy, netlify-function, api
46
- */
47
- export declare const handler: (event: any, context: any) => Promise<any>;
48
- //# sourceMappingURL=account-nodes.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"account-nodes.d.ts","sourceRoot":"","sources":["../../.framework/functions/account-nodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,4CA2DlB,CAAA"}