spine-framework 0.4.3 → 0.5.0-rc.4

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 (320) hide show
  1. package/.env.example +13 -3
  2. package/.framework/cli/commands/bootstrap.ts +392 -0
  3. package/.framework/cli/commands/dev.ts +91 -218
  4. package/.framework/cli/commands/doctor.ts +132 -26
  5. package/.framework/cli/commands/generate.ts +38 -298
  6. package/.framework/cli/commands/init.ts +20 -1
  7. package/.framework/cli/commands/migrate.ts +36 -30
  8. package/.framework/cli/commands/migrations.ts +16 -56
  9. package/.framework/cli/commands/upgrade.ts +35 -0
  10. package/.framework/cli/commands/validate-schema.ts +147 -0
  11. package/.framework/cli/context.ts +223 -110
  12. package/.framework/cli/index.ts +6 -0
  13. package/.framework/cli/lib/project-files.ts +241 -1
  14. package/.framework/functions/_shared/agent-runner.ts +1000 -81
  15. package/.framework/functions/_shared/cil.ts +2 -1
  16. package/.framework/functions/_shared/db.ts +3 -6
  17. package/.framework/functions/_shared/hash-api-key.ts +183 -79
  18. package/.framework/functions/_shared/kb.ts +61 -7
  19. package/.framework/functions/_shared/logging.ts +562 -224
  20. package/.framework/functions/_shared/message-sequence.ts +53 -0
  21. package/.framework/functions/_shared/middleware.ts +47 -44
  22. package/.framework/functions/_shared/pipeline-runner.ts +150 -37
  23. package/.framework/functions/_shared/principal.ts +9 -6
  24. package/.framework/functions/_shared/trigger-engine.ts +149 -40
  25. package/.framework/functions/admin-data.ts +48 -31
  26. package/.framework/functions/ai-agents.ts +103 -33
  27. package/.framework/functions/api-keys.ts +301 -122
  28. package/.framework/functions/apps.ts +43 -26
  29. package/.framework/functions/cil-ingest.ts +48 -15
  30. package/.framework/functions/debug-auth.ts +14 -8
  31. package/.framework/functions/deliveries.ts +39 -12
  32. package/.framework/functions/embeddings.ts +145 -76
  33. package/.framework/functions/integration-outbound.ts +67 -27
  34. package/.framework/functions/integrations.ts +254 -127
  35. package/.framework/functions/logs.ts +273 -133
  36. package/.framework/functions/observability.ts +277 -147
  37. package/.framework/functions/pipeline-executions.ts +1 -1
  38. package/.framework/functions/pipeline-runner-background.ts +120 -0
  39. package/.framework/functions/pipelines.ts +14 -9
  40. package/.framework/functions/prompt-configs.ts +7 -4
  41. package/.framework/functions/roles.ts +8 -5
  42. package/.framework/functions/security.ts +30 -17
  43. package/.framework/functions/system-cron.ts +250 -128
  44. package/.framework/functions/tests.ts +7 -6
  45. package/.framework/functions/timers.ts +310 -107
  46. package/.framework/functions/trigger-scheduler.ts +65 -5
  47. package/.framework/functions/triggers.ts +28 -13
  48. package/.framework/functions/types.ts +13 -10
  49. package/.framework/migrations/064_episode_leases.sql +196 -0
  50. package/.framework/migrations/065_execution_tables_updated_at.sql +20 -0
  51. package/.framework/migrations/066_episode_steal_thread_merge.sql +148 -0
  52. package/.framework/migrations/067_episode_lease_stale_steal.sql +93 -0
  53. package/.framework/migrations/068_cron_schedule_timer_rpcs.sql +251 -0
  54. package/.framework/migrations/069_log_stats_window.sql +54 -0
  55. package/.framework/migrations/070_app_type_schema_rpcs.sql +166 -0
  56. package/.framework/migrations/071_timer_interval_keys.sql +96 -0
  57. package/.framework/migrations/072_slug_autofill.sql +77 -0
  58. package/.framework/migrations/073_seed_member_roles.sql +26 -0
  59. package/.framework/schemas/spine.config.schema.json +62 -0
  60. package/.framework/src/App.tsx +3 -1
  61. package/.framework/src/apps/admin/index.tsx +1141 -775
  62. package/.framework/src/components/ErrorBoundary.tsx +136 -0
  63. package/.framework/src/components/admin/AdminListPage.tsx +81 -73
  64. package/.framework/src/components/admin/AdminSidebar.tsx +92 -81
  65. package/.framework/src/components/admin/EntitySelect.tsx +181 -0
  66. package/.framework/src/components/admin/PageInstructions.tsx +86 -127
  67. package/.framework/src/components/app-shell/GenericAppShell.tsx +3 -1
  68. package/.framework/src/components/app-shell/GenericDetailPage.tsx +37 -13
  69. package/.framework/src/components/app-shell/GenericListPage.tsx +28 -32
  70. package/.framework/src/components/auth/TurnstileWidget.tsx +9 -6
  71. package/.framework/src/components/kb/KBArticleEditor.tsx +49 -6
  72. package/.framework/src/components/layout/Layout.tsx +4 -2
  73. package/.framework/src/components/layout/Sidebar.tsx +304 -179
  74. package/.framework/src/components/runtime/DataDetailPage.tsx +67 -35
  75. package/.framework/src/components/runtime/DataHeader.tsx +96 -48
  76. package/.framework/src/components/runtime/DataListPage.tsx +3 -26
  77. package/.framework/src/components/runtime/DataStats.tsx +10 -10
  78. package/.framework/src/components/runtime/DataTable.tsx +12 -10
  79. package/.framework/src/components/ui/sheet.tsx +24 -26
  80. package/.framework/src/components/ui/textarea.tsx +74 -48
  81. package/.framework/src/hooks/useBranding.ts +47 -0
  82. package/.framework/src/hooks/useEntityList.ts +12 -9
  83. package/.framework/src/hooks/useListSchema.ts +108 -58
  84. package/.framework/src/instructions/README.md +57 -0
  85. package/.framework/src/instructions/ai-agents.md +69 -0
  86. package/.framework/src/instructions/alerts.md +80 -0
  87. package/.framework/src/instructions/api-keys.md +87 -0
  88. package/.framework/src/instructions/apps.md +77 -0
  89. package/.framework/src/instructions/concepts/ai-and-prompts.md +150 -0
  90. package/.framework/src/instructions/concepts/apps-and-renderers.md +162 -0
  91. package/.framework/src/instructions/concepts/auth-and-api-keys.md +133 -0
  92. package/.framework/src/instructions/concepts/automation.md +186 -0
  93. package/.framework/src/instructions/concepts/concurrency-and-idempotency.md +125 -0
  94. package/.framework/src/instructions/concepts/core-vs-custom.md +124 -0
  95. package/.framework/src/instructions/concepts/design-schema.md +152 -0
  96. package/.framework/src/instructions/concepts/integrations-and-webhooks.md +127 -0
  97. package/.framework/src/instructions/concepts/observability.md +116 -0
  98. package/.framework/src/instructions/concepts/permissions.md +150 -0
  99. package/.framework/src/instructions/concepts/runtime-records.md +111 -0
  100. package/.framework/src/instructions/concepts/scope-and-accounts.md +112 -0
  101. package/.framework/src/instructions/concepts/spine-way.md +172 -0
  102. package/.framework/src/instructions/deliveries.md +59 -0
  103. package/.framework/src/instructions/guide/00-orientation.md +106 -0
  104. package/.framework/src/instructions/guide/01-install-and-first-run.md +253 -0
  105. package/.framework/src/instructions/guide/02-project-map.md +147 -0
  106. package/.framework/src/instructions/guide/03-domain-model.md +223 -0
  107. package/.framework/src/instructions/guide/04-first-app.md +227 -0
  108. package/.framework/src/instructions/guide/05-glossary.md +183 -0
  109. package/.framework/src/instructions/integrations.md +96 -0
  110. package/.framework/src/instructions/internal/cil-markers.md +83 -0
  111. package/.framework/src/instructions/invites.md +60 -0
  112. package/.framework/src/instructions/kb.md +80 -0
  113. package/.framework/src/instructions/logs.md +77 -0
  114. package/.framework/src/instructions/observability.md +61 -0
  115. package/.framework/src/instructions/operations/deployment.md +115 -0
  116. package/.framework/src/instructions/operations/migrations.md +125 -0
  117. package/.framework/src/instructions/operations/security-checklist.md +148 -0
  118. package/.framework/src/instructions/operations/troubleshooting.md +170 -0
  119. package/.framework/src/instructions/operations/upgrade.md +116 -0
  120. package/.framework/src/instructions/pipeline-executions.md +62 -0
  121. package/.framework/src/instructions/pipelines.md +78 -0
  122. package/.framework/src/instructions/prompts.md +95 -0
  123. package/.framework/src/instructions/reference/api/admin-data.md +162 -0
  124. package/.framework/src/instructions/reference/api/auth.md +113 -0
  125. package/.framework/src/instructions/reference/api/errors-and-envelopes.md +113 -0
  126. package/.framework/src/instructions/reference/app-manifest.md +150 -0
  127. package/.framework/src/instructions/reference/cli.md +124 -0
  128. package/.framework/src/instructions/reference/database.md +132 -0
  129. package/.framework/src/instructions/reference/design-schema.md +280 -0
  130. package/.framework/src/instructions/reference/env-vars.md +133 -0
  131. package/.framework/src/instructions/reference/functions/account-nodes.md +75 -0
  132. package/.framework/src/instructions/reference/functions/admin-data.md +195 -0
  133. package/.framework/src/instructions/reference/functions/admin-funnel.md +90 -0
  134. package/.framework/src/instructions/reference/functions/admin-install-funnel.md +107 -0
  135. package/.framework/src/instructions/reference/functions/admin-signals.md +102 -0
  136. package/.framework/src/instructions/reference/functions/ai-agents.md +148 -0
  137. package/.framework/src/instructions/reference/functions/ai-interactions.md +156 -0
  138. package/.framework/src/instructions/reference/functions/api-keys.md +130 -0
  139. package/.framework/src/instructions/reference/functions/apps.md +140 -0
  140. package/.framework/src/instructions/reference/functions/auth.md +99 -0
  141. package/.framework/src/instructions/reference/functions/debug-auth.md +91 -0
  142. package/.framework/src/instructions/reference/functions/deliveries.md +110 -0
  143. package/.framework/src/instructions/reference/functions/embeddings.md +166 -0
  144. package/.framework/src/instructions/reference/functions/eval-harness.md +149 -0
  145. package/.framework/src/instructions/reference/functions/index.md +103 -0
  146. package/.framework/src/instructions/reference/functions/integration-outbound.md +200 -0
  147. package/.framework/src/instructions/reference/functions/integration-routes.md +151 -0
  148. package/.framework/src/instructions/reference/functions/integrations.md +130 -0
  149. package/.framework/src/instructions/reference/functions/invites.md +182 -0
  150. package/.framework/src/instructions/reference/functions/item-progress.md +107 -0
  151. package/.framework/src/instructions/reference/functions/kb.md +166 -0
  152. package/.framework/src/instructions/reference/functions/logs.md +141 -0
  153. package/.framework/src/instructions/reference/functions/observability.md +105 -0
  154. package/.framework/src/instructions/reference/functions/pipeline-executions.md +132 -0
  155. package/.framework/src/instructions/reference/functions/pipeline-runner-background.md +121 -0
  156. package/.framework/src/instructions/reference/functions/pipelines.md +136 -0
  157. package/.framework/src/instructions/reference/functions/prompt-configs.md +121 -0
  158. package/.framework/src/instructions/reference/functions/roles.md +121 -0
  159. package/.framework/src/instructions/reference/functions/security.md +140 -0
  160. package/.framework/src/instructions/reference/functions/system-cron.md +136 -0
  161. package/.framework/src/instructions/reference/functions/system.md +106 -0
  162. package/.framework/src/instructions/reference/functions/tests.md +97 -0
  163. package/.framework/src/instructions/reference/functions/timers.md +117 -0
  164. package/.framework/src/instructions/reference/functions/trigger-scheduler.md +102 -0
  165. package/.framework/src/instructions/reference/functions/triggers.md +140 -0
  166. package/.framework/src/instructions/reference/functions/types.md +146 -0
  167. package/.framework/src/instructions/reference/seeds.md +126 -0
  168. package/.framework/src/instructions/reference/shared-modules.md +127 -0
  169. package/.framework/src/instructions/reference/spine-config.md +114 -0
  170. package/.framework/src/instructions/roles.md +80 -0
  171. package/.framework/src/instructions/runtime-detail.md +70 -0
  172. package/.framework/src/instructions/runtime-list.md +77 -0
  173. package/.framework/src/instructions/security.md +67 -0
  174. package/.framework/src/instructions/tasks/add-a-pipeline.md +110 -0
  175. package/.framework/src/instructions/tasks/add-a-role.md +96 -0
  176. package/.framework/src/instructions/tasks/add-a-timer.md +114 -0
  177. package/.framework/src/instructions/tasks/add-a-trigger.md +106 -0
  178. package/.framework/src/instructions/tasks/add-a-type.md +151 -0
  179. package/.framework/src/instructions/tasks/add-a-webhook.md +108 -0
  180. package/.framework/src/instructions/tasks/add-an-ai-agent.md +108 -0
  181. package/.framework/src/instructions/tasks/add-an-integration.md +124 -0
  182. package/.framework/src/instructions/tasks/build-a-custom-page.md +118 -0
  183. package/.framework/src/instructions/tasks/package-and-install-an-app.md +127 -0
  184. package/.framework/src/instructions/tasks/test-your-code.md +108 -0
  185. package/.framework/src/instructions/tasks/write-a-function.md +132 -0
  186. package/.framework/src/instructions/tasks/write-a-migration.md +110 -0
  187. package/.framework/src/instructions/testing.md +59 -0
  188. package/.framework/src/instructions/timers.md +82 -0
  189. package/.framework/src/instructions/triggers.md +69 -0
  190. package/.framework/src/instructions/types.md +93 -0
  191. package/.framework/src/lib/branding.ts +128 -0
  192. package/.framework/src/pages/NoAppPage.tsx +3 -1
  193. package/.framework/src/pages/NotFoundPage.tsx +62 -31
  194. package/.framework/src/pages/SetupPage.tsx +5 -2
  195. package/.framework/src/pages/admin/AIAgentDetailPage.tsx +117 -106
  196. package/.framework/src/pages/admin/AIAgentsPage.tsx +86 -48
  197. package/.framework/src/pages/admin/APIKeyDetailPage.tsx +153 -152
  198. package/.framework/src/pages/admin/APIKeysPage.tsx +91 -90
  199. package/.framework/src/pages/admin/AlertsConfigPage.tsx +29 -18
  200. package/.framework/src/pages/admin/AppDetailPage.tsx +6 -60
  201. package/.framework/src/pages/admin/AppsPage.tsx +104 -66
  202. package/.framework/src/pages/admin/DeliveriesPage.tsx +5 -5
  203. package/.framework/src/pages/admin/EmbeddingDetailPage.tsx +5 -23
  204. package/.framework/src/pages/admin/EmbeddingsPage.tsx +5 -26
  205. package/.framework/src/pages/admin/IntegrationDetailPage.tsx +7 -7
  206. package/.framework/src/pages/admin/IntegrationsPage.tsx +85 -43
  207. package/.framework/src/pages/admin/LogsPage.tsx +144 -76
  208. package/.framework/src/pages/admin/ObservabilityDashboard.tsx +223 -140
  209. package/.framework/src/pages/admin/PipelineDetailPage.tsx +134 -113
  210. package/.framework/src/pages/admin/PipelineExecutionsPage.tsx +108 -45
  211. package/.framework/src/pages/admin/PipelinesPage.tsx +160 -115
  212. package/.framework/src/pages/admin/PromptConfigDetailPage.tsx +96 -98
  213. package/.framework/src/pages/admin/PromptConfigsPage.tsx +101 -59
  214. package/.framework/src/pages/admin/RoleDetailPage.tsx +90 -79
  215. package/.framework/src/pages/admin/RolesPage.tsx +86 -43
  216. package/.framework/src/pages/admin/SecurityPage.tsx +1 -1
  217. package/.framework/src/pages/admin/TestingDashboard.tsx +16 -28
  218. package/.framework/src/pages/admin/TimerDetailPage.tsx +117 -100
  219. package/.framework/src/pages/admin/TimersPage.tsx +90 -62
  220. package/.framework/src/pages/admin/TriggerDetailPage.tsx +90 -83
  221. package/.framework/src/pages/admin/TriggersPage.tsx +124 -99
  222. package/.framework/src/pages/admin/TypeDetailPage.tsx +152 -138
  223. package/.framework/src/pages/admin/TypesPage.tsx +90 -48
  224. package/.framework/src/pages/admin/cil/CILAgentPage.tsx +17 -25
  225. package/.framework/src/pages/admin/cil/CILChunkDetailPage.tsx +17 -27
  226. package/.framework/src/pages/admin/cil/CILDashboardPage.tsx +72 -40
  227. package/.framework/src/pages/admin/cil/CILFileListPage.tsx +321 -129
  228. package/.framework/src/pages/admin/cil/CILFileSelectPage.tsx +18 -29
  229. package/.framework/src/pages/admin/cil/CILGraphPage.tsx +26 -38
  230. package/.framework/src/pages/admin/cil/CILIngestionPage.tsx +34 -46
  231. package/.framework/src/pages/admin/cil/CILProjectsPage.tsx +189 -103
  232. package/.framework/src/pages/admin/cil/CILSearchPage.tsx +246 -136
  233. package/.framework/src/pages/admin/cil/CILSuggestionsPage.tsx +11 -22
  234. package/.framework/src/pages/admin/cil/CILVersionsPage.tsx +9 -20
  235. package/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx +26 -38
  236. package/.framework/src/pages/admin/kb/KBAdminPage.tsx +7 -26
  237. package/.framework/src/pages/auth/AuthConfirmPage.tsx +3 -1
  238. package/.framework/src/pages/auth/ForgotPasswordPage.tsx +3 -1
  239. package/.framework/src/pages/auth/LoginPage.tsx +4 -2
  240. package/.framework/src/pages/auth/RegisterPage.tsx +3 -1
  241. package/.framework/templates/agent/AGENTS.md +150 -0
  242. package/.framework/templates/agent/skills/spine-add-ai-agent/SKILL.md +58 -0
  243. package/.framework/templates/agent/skills/spine-add-automation/SKILL.md +62 -0
  244. package/.framework/templates/agent/skills/spine-add-integration/SKILL.md +63 -0
  245. package/.framework/templates/agent/skills/spine-architect/SKILL.md +86 -0
  246. package/.framework/templates/agent/skills/spine-install-app/SKILL.md +72 -0
  247. package/.framework/templates/agent/skills/spine-migration/SKILL.md +75 -0
  248. package/.framework/templates/agent/skills/spine-new-app/SKILL.md +67 -0
  249. package/.framework/templates/agent/skills/spine-new-function/SKILL.md +65 -0
  250. package/.framework/templates/agent/skills/spine-new-type/SKILL.md +65 -0
  251. package/.framework/templates/agent/skills/spine-schema/SKILL.md +77 -0
  252. package/.framework/templates/agent/skills/spine-test/SKILL.md +67 -0
  253. package/.framework/templates/agent/skills/spine-troubleshoot/SKILL.md +74 -0
  254. package/.framework/templates/agent/skills/spine-upgrade/SKILL.md +69 -0
  255. package/.framework/templates/project.json +5 -1
  256. package/.framework/tests/unit/account-scoping-gates.test.ts +392 -0
  257. package/.framework/tests/unit/agent-files.test.ts +355 -0
  258. package/.framework/tests/unit/agent-runner.test.ts +496 -47
  259. package/.framework/tests/unit/api-keys-create-scope-gate.test.ts +160 -0
  260. package/.framework/tests/unit/api-keys-omit-secret-fields.test.ts +38 -0
  261. package/.framework/tests/unit/bootstrap.test.ts +242 -0
  262. package/.framework/tests/unit/cli-context-api-key.test.ts +114 -0
  263. package/.framework/tests/unit/debug-auth.test.ts +38 -0
  264. package/.framework/tests/unit/deliveries-account-scoping.test.ts +185 -0
  265. package/.framework/tests/unit/episode-lease.test.ts +695 -0
  266. package/.framework/tests/unit/integration-outbound-credentials.test.ts +167 -0
  267. package/.framework/tests/unit/integrations-audit-redaction.test.ts +130 -0
  268. package/.framework/tests/unit/kb-ingest-lease.test.ts +19 -0
  269. package/.framework/tests/unit/logging-app-id.test.ts +75 -0
  270. package/.framework/tests/unit/pipeline-runner-background.test.ts +120 -0
  271. package/.framework/tests/unit/pipeline-runner.test.ts +153 -1
  272. package/.framework/tests/unit/principal-cache.test.ts +15 -0
  273. package/.framework/tests/unit/system-context-denial.test.ts +145 -0
  274. package/.framework/tests/unit/system-cron.test.ts +240 -0
  275. package/.framework/tests/unit/timers.test.ts +159 -0
  276. package/.framework/tests/unit/trigger-engine.test.ts +278 -91
  277. package/.framework/tests/unit/trigger-scheduler.test.ts +78 -0
  278. package/README.md +125 -166
  279. package/config/tsconfig.cli.json +2 -2
  280. package/netlify.toml +5 -0
  281. package/package.json +15 -4
  282. package/templates/project/package-lock.json +2 -2
  283. package/.framework/docs/admin-routes.md +0 -76
  284. package/.framework/docs/api-docs-progress.md +0 -38
  285. package/.framework/docs/api-governance.md +0 -146
  286. package/.framework/docs/api-testing-results.md +0 -212
  287. package/.framework/docs/assembly-launch-guide.md +0 -138
  288. package/.framework/docs/audit-results.md +0 -590
  289. package/.framework/docs/db-api-inventory.md +0 -95
  290. package/.framework/docs/gap-remediation-backlog.md +0 -103
  291. package/.framework/docs/ui-adoption-verification.md +0 -111
  292. package/.framework/docs/ui-api-coverage.md +0 -84
  293. package/.framework/docs/v2-compatibility-audit.md +0 -228
  294. package/.framework/mcp/index.ts +0 -133
  295. package/.framework/mcp/load-env.ts +0 -60
  296. package/.framework/mcp/shared/app-manifest.ts +0 -275
  297. package/.framework/mcp/shared/db.ts +0 -477
  298. package/.framework/mcp/shared/kb.ts +0 -118
  299. package/.framework/mcp/tools/architect.ts +0 -431
  300. package/.framework/mcp/tools/cil/context.ts +0 -345
  301. package/.framework/mcp/tools/cil/graph.ts +0 -242
  302. package/.framework/mcp/tools/cil/ingest.ts +0 -1217
  303. package/.framework/mcp/tools/cil/pipeline-orchestrator.ts +0 -693
  304. package/.framework/mcp/tools/cil/pipeline.ts +0 -767
  305. package/.framework/mcp/tools/cil/project.ts +0 -791
  306. package/.framework/mcp/tools/cil/retrieval.ts +0 -336
  307. package/.framework/mcp/tools/cil/search-core.ts +0 -454
  308. package/.framework/mcp/tools/cil/search.ts +0 -97
  309. package/.framework/mcp/tools/cil/suggest.ts +0 -186
  310. package/.framework/mcp/tools/cil/validate.ts +0 -1369
  311. package/.framework/mcp/tools/kb/delete.ts +0 -139
  312. package/.framework/mcp/tools/kb/index.ts +0 -52
  313. package/.framework/mcp/tools/kb/ingest.ts +0 -84
  314. package/.framework/mcp/tools/kb/list-types.ts +0 -102
  315. package/.framework/mcp/tools/kb/publish.ts +0 -100
  316. package/.framework/mcp/tools/kb/reindex.ts +0 -86
  317. package/.framework/mcp/tools/kb/revoke.ts +0 -85
  318. package/.framework/mcp/tools/kb/search.ts +0 -101
  319. package/.framework/mcp/tools/kb/upsert.ts +0 -125
  320. package/.framework/mcp/tools/observability.ts +0 -510
@@ -0,0 +1,160 @@
1
+ import { describe, it, expect, vi, beforeEach } from 'vitest'
2
+
3
+ // S-011: api-keys create accepted `scopes` and `is_internal` verbatim, so any
4
+ // scoped machine caller (service-role ctx.db) could mint a `*:*` or
5
+ // `is_internal` key and escalate itself. These tests pin the gate: wildcard
6
+ // scopes and internal keys are system-principal-only (403 otherwise), other
7
+ // requested scopes are clipped to the caller's own, and an omitted scopes
8
+ // list inherits the caller's scopes.
9
+
10
+ vi.mock('../../functions/_shared/middleware.ts', () => ({
11
+ createHandler: (fn: any) => fn,
12
+ json: vi.fn(),
13
+ error: vi.fn(),
14
+ parseBody: vi.fn(),
15
+ }))
16
+
17
+ vi.mock('../../functions/_shared/db.ts', () => ({
18
+ adminDb: {
19
+ from: vi.fn(),
20
+ rpc: vi.fn(),
21
+ },
22
+ getUserDb: vi.fn(() => ({})),
23
+ }))
24
+
25
+ vi.mock('../../functions/_shared/audit.ts', () => ({
26
+ emitAudit: vi.fn().mockResolvedValue(undefined),
27
+ emitLog: vi.fn().mockResolvedValue(undefined),
28
+ emitSpan: vi.fn().mockResolvedValue(undefined),
29
+ emitActivity: vi.fn().mockResolvedValue(undefined),
30
+ }))
31
+
32
+ vi.mock('../../functions/_shared/permissions.ts', () => ({
33
+ sanitizeRecordData: vi.fn(async (_ctx: any, record: any) => record),
34
+ }))
35
+
36
+ vi.mock('../../functions/_shared/logging.ts', () => ({
37
+ resolveAppUuid: vi.fn(async (ref: any) => ref ?? null),
38
+ }))
39
+
40
+ import { create } from '../../functions/api-keys.ts'
41
+
42
+ // Chainable query-builder stub — filter/chain methods return the builder;
43
+ // single/maybeSingle/await resolve to the queued result.
44
+ function q(result: { data?: any; error?: any }) {
45
+ const b: any = {}
46
+ const chainers = ['select', 'eq', 'in', 'is', 'order', 'limit', 'update',
47
+ 'insert', 'upsert', 'delete', 'or', 'gte', 'lte', 'range']
48
+ for (const m of chainers) b[m] = vi.fn(() => b)
49
+ b.single = vi.fn(async () => result)
50
+ b.maybeSingle = vi.fn(async () => result)
51
+ b.then = (onF: any, onR: any) => Promise.resolve(result).then(onF, onR)
52
+ return b
53
+ }
54
+
55
+ let queue: any[] = []
56
+ let dbBuilt: any[] = []
57
+
58
+ function stubDb() {
59
+ return {
60
+ from: vi.fn(() => {
61
+ const b = queue.length ? queue.shift() : q({ data: null, error: null })
62
+ dbBuilt.push(b)
63
+ return b
64
+ }),
65
+ rpc: vi.fn(async () => ({ data: [], error: null })),
66
+ }
67
+ }
68
+
69
+ beforeEach(() => {
70
+ queue = []
71
+ dbBuilt = []
72
+ vi.clearAllMocks()
73
+ })
74
+
75
+ const scopedMachine = (scopes: string[] = ['logs:read'], accountId: string | null = 'acct-1') => ({
76
+ id: 'key-1',
77
+ type: 'machine',
78
+ accountId,
79
+ roles: [],
80
+ scopes,
81
+ isInternal: false,
82
+ machineType: 'integration',
83
+ provenance: { sourceType: 'api_key' },
84
+ })
85
+
86
+ const systemAdmin = () => ({
87
+ id: 'user-1',
88
+ type: 'human',
89
+ accountId: 'acct-1',
90
+ roles: ['system_admin'],
91
+ provenance: { sourceType: 'jwt' },
92
+ })
93
+
94
+ function makeCtx(principal: any, overrides: any = {}) {
95
+ return {
96
+ requestId: 'req-1',
97
+ principal,
98
+ accountId: principal?.accountId ?? null,
99
+ db: stubDb(),
100
+ query: {},
101
+ headers: {},
102
+ ...overrides,
103
+ }
104
+ }
105
+
106
+ // Queue a successful insert for create() and return the builder's insert spy.
107
+ function queueInsert() {
108
+ const b = q({ data: { id: 'key-9', name: 'k', key_type: 'inbound' }, error: null })
109
+ queue.push(b)
110
+ return b
111
+ }
112
+
113
+ describe('api-keys create privilege gate (S-011)', () => {
114
+ it('denies a scoped machine caller minting a *:* key with statusCode 403', async () => {
115
+ const ctx = makeCtx(scopedMachine())
116
+ await expect(
117
+ create(ctx, { name: 'escalated', scopes: ['*:*'] })
118
+ ).rejects.toMatchObject({ statusCode: 403 })
119
+ expect(ctx.db.from).not.toHaveBeenCalled()
120
+ })
121
+
122
+ it('denies a scoped machine caller minting an is_internal key with statusCode 403', async () => {
123
+ const ctx = makeCtx(scopedMachine())
124
+ await expect(
125
+ create(ctx, { name: 'internal', is_internal: true })
126
+ ).rejects.toMatchObject({ statusCode: 403 })
127
+ expect(ctx.db.from).not.toHaveBeenCalled()
128
+ })
129
+
130
+ it('clips requested scopes to the scopes the caller already holds', async () => {
131
+ const b = queueInsert()
132
+ const ctx = makeCtx(scopedMachine(['logs:read', 'items:read']))
133
+ await create(ctx, { name: 'clipped', scopes: ['logs:read', 'admin:write', '*'] })
134
+ expect(b.insert).toHaveBeenCalledWith(expect.objectContaining({
135
+ scopes: ['logs:read'],
136
+ is_internal: false,
137
+ }))
138
+ })
139
+
140
+ it('inherits the caller\u2019s own scopes when scopes is omitted', async () => {
141
+ const b = queueInsert()
142
+ const ctx = makeCtx(scopedMachine(['logs:read', 'items:write']))
143
+ await create(ctx, { name: 'inherits' })
144
+ expect(b.insert).toHaveBeenCalledWith(expect.objectContaining({
145
+ scopes: ['logs:read', 'items:write'],
146
+ is_internal: false,
147
+ }))
148
+ })
149
+
150
+ it('lets a system_admin mint a wildcard-scoped internal key', async () => {
151
+ const b = queueInsert()
152
+ const ctx = makeCtx(systemAdmin())
153
+ const res = await create(ctx, { name: 'root', scopes: ['*:*'], is_internal: true })
154
+ expect(res.raw_key).toMatch(/^sk_/)
155
+ expect(b.insert).toHaveBeenCalledWith(expect.objectContaining({
156
+ scopes: ['*:*'],
157
+ is_internal: true,
158
+ }))
159
+ })
160
+ })
@@ -0,0 +1,38 @@
1
+ import { describe, it, expect } from 'vitest'
2
+ import { omitSecretFields } from '../../functions/_shared/hash-api-key'
3
+
4
+ describe('omitSecretFields', () => {
5
+ it('removes key_value and key_hash and keeps the other fields', () => {
6
+ const row = { id: 'key-1', name: 'Prod', key_prefix: 'sk_abc123', key_hash: 'hash', key_value: 'sk_secret' }
7
+ const result = omitSecretFields(row)
8
+ expect(result).toEqual({ id: 'key-1', name: 'Prod', key_prefix: 'sk_abc123' })
9
+ expect(result).not.toHaveProperty('key_value')
10
+ expect(result).not.toHaveProperty('key_hash')
11
+ })
12
+
13
+ it('does not mutate the input row', () => {
14
+ const row = { id: 'key-1', key_value: 'sk_secret', key_hash: 'hash' }
15
+ omitSecretFields(row)
16
+ expect(row.key_value).toBe('sk_secret')
17
+ expect(row.key_hash).toBe('hash')
18
+ })
19
+
20
+ it('returns null and undefined input as-is', () => {
21
+ expect(omitSecretFields(null)).toBeNull()
22
+ expect(omitSecretFields(undefined)).toBeUndefined()
23
+ })
24
+
25
+ it('returns an equal copy for a row without secret fields', () => {
26
+ const row = { id: 'key-1', name: 'Prod', is_active: true, metadata: { env: 'prod' } }
27
+ const result = omitSecretFields(row)
28
+ expect(result).toEqual(row)
29
+ expect(result).not.toBe(row)
30
+ })
31
+
32
+ it('strips key_hash even when it is the only secret field present', () => {
33
+ const row = { id: 'key-2', name: 'CI', key_hash: 'pbkdf2$100000$salt$hash' }
34
+ const result = omitSecretFields(row)
35
+ expect(result).toEqual({ id: 'key-2', name: 'CI' })
36
+ expect(result).not.toHaveProperty('key_hash')
37
+ })
38
+ })
@@ -0,0 +1,242 @@
1
+ import { describe, it, expect, beforeEach, vi } from 'vitest'
2
+ import { verifyApiKey } from '../../functions/_shared/hash-api-key'
3
+
4
+ // S-002: `spine-framework bootstrap` provisions the first system_admin and
5
+ // mints the first sk_ key without a browser. These tests pin the idempotent
6
+ // skip, the register-path row shape, the auth-user path, and the
7
+ // hash-only key storage.
8
+
9
+ type DbCall = { op: string; args: any[] }
10
+ type DbQuery = { table: string; calls: DbCall[] }
11
+ type DbResult = { data?: any; error?: any }
12
+
13
+ const supaState = vi.hoisted(() => ({
14
+ responder: null as null | ((q: DbQuery) => DbResult),
15
+ history: [] as DbQuery[],
16
+ createUser: vi.fn(),
17
+ }))
18
+
19
+ vi.mock('@supabase/supabase-js', () => ({
20
+ createClient: () => ({
21
+ from(table: string) {
22
+ const calls: DbCall[] = []
23
+ const query: DbQuery = { table, calls }
24
+ const builder: any = {
25
+ select(...a: any[]) { calls.push({ op: 'select', args: a }); return builder },
26
+ upsert(...a: any[]) { calls.push({ op: 'upsert', args: a }); return builder },
27
+ update(...a: any[]) { calls.push({ op: 'update', args: a }); return builder },
28
+ insert(...a: any[]) { calls.push({ op: 'insert', args: a }); return builder },
29
+ eq(...a: any[]) { calls.push({ op: 'eq', args: a }); return builder },
30
+ neq(...a: any[]) { calls.push({ op: 'neq', args: a }); return builder },
31
+ in(...a: any[]) { calls.push({ op: 'in', args: a }); return builder },
32
+ is(...a: any[]) { calls.push({ op: 'is', args: a }); return builder },
33
+ or(...a: any[]) { calls.push({ op: 'or', args: a }); return builder },
34
+ order(...a: any[]) { calls.push({ op: 'order', args: a }); return builder },
35
+ limit(...a: any[]) { calls.push({ op: 'limit', args: a }); return builder },
36
+ range(...a: any[]) { calls.push({ op: 'range', args: a }); return builder },
37
+ single() { supaState.history.push(query); return Promise.resolve(supaState.responder!(query)) },
38
+ maybeSingle() { supaState.history.push(query); return Promise.resolve(supaState.responder!(query)) },
39
+ then(res: any, rej: any) {
40
+ supaState.history.push(query)
41
+ return Promise.resolve(supaState.responder!(query)).then(res, rej)
42
+ },
43
+ }
44
+ return builder
45
+ },
46
+ auth: {
47
+ admin: {
48
+ createUser: (...args: any[]) => supaState.createUser(...args),
49
+ },
50
+ },
51
+ }),
52
+ }))
53
+
54
+ vi.mock('../../functions/_shared/audit.ts', () => ({
55
+ emitAudit: vi.fn(async () => {}),
56
+ emitSpan: vi.fn(async () => {}),
57
+ emitLog: vi.fn(async () => {}),
58
+ emitActivity: vi.fn(async () => {}),
59
+ }))
60
+
61
+ import { createClient } from '@supabase/supabase-js'
62
+ import { runBootstrap } from '../../cli/commands/bootstrap'
63
+ import { emitLog } from '../../functions/_shared/audit'
64
+
65
+ // Per-test table state. `people` routes on recorded ops: `limit` = the
66
+ // idempotent system_admin existence check, `insert`/`update` = writes,
67
+ // anything else = the email lookup (maybeSingle).
68
+ const tables = {
69
+ account: { id: 'acct-spine' } as any,
70
+ role: { id: 'role-admin' } as any,
71
+ personType: { id: 'type-person', design_schema: { fields: {} }, validation_schema: {} } as any,
72
+ existingAdmins: [] as any[],
73
+ personByEmail: null as any,
74
+ }
75
+
76
+ function defaultResponder(q: DbQuery): DbResult {
77
+ const ops = q.calls.map((c) => c.op)
78
+ switch (q.table) {
79
+ case 'accounts':
80
+ return { data: tables.account, error: null }
81
+ case 'roles':
82
+ return { data: tables.role, error: null }
83
+ case 'types':
84
+ return { data: tables.personType, error: null }
85
+ case 'people':
86
+ if (ops.includes('insert')) return { data: { id: 'person-new' }, error: null }
87
+ if (ops.includes('update')) return { data: null, error: null }
88
+ if (ops.includes('limit')) return { data: tables.existingAdmins, error: null }
89
+ return { data: tables.personByEmail, error: null }
90
+ case 'api_keys': {
91
+ const row = q.calls.find((c) => c.op === 'insert')?.args?.[0] || {}
92
+ return {
93
+ data: { id: 'key-1', name: row.name, key_prefix: row.key_prefix, scopes: row.scopes },
94
+ error: null,
95
+ }
96
+ }
97
+ default:
98
+ return { data: null, error: null }
99
+ }
100
+ }
101
+
102
+ function queriesTo(table: string, op?: string): DbQuery[] {
103
+ return supaState.history.filter(
104
+ (q) => q.table === table && (!op || q.calls.some((c) => c.op === op))
105
+ )
106
+ }
107
+
108
+ function insertedRow(table: string): any {
109
+ const q = queriesTo(table, 'insert')[0]
110
+ return q?.calls.find((c) => c.op === 'insert')?.args?.[0]
111
+ }
112
+
113
+ beforeEach(() => {
114
+ supaState.history = []
115
+ supaState.createUser.mockReset()
116
+ vi.mocked(emitLog).mockClear()
117
+ tables.account = { id: 'acct-spine' }
118
+ tables.role = { id: 'role-admin' }
119
+ tables.personType = { id: 'type-person', design_schema: { fields: {} }, validation_schema: {} }
120
+ tables.existingAdmins = []
121
+ tables.personByEmail = null
122
+ supaState.responder = defaultResponder
123
+ })
124
+
125
+ function db() {
126
+ return createClient('https://example.supabase.co', 'service-key') as any
127
+ }
128
+
129
+ describe('bootstrap idempotency', () => {
130
+ it('skips person creation when a system_admin already exists, still mints a key', async () => {
131
+ tables.existingAdmins = [{ id: 'person-admin', email: 'root@x.com' }]
132
+
133
+ const result = await runBootstrap(db(), {})
134
+
135
+ expect(result.admin).toBe('existing')
136
+ expect(result.personId).toBe('person-admin')
137
+ expect(result.authUserCreated).toBe(false)
138
+ expect(queriesTo('people', 'insert')).toHaveLength(0)
139
+ expect(queriesTo('people', 'update')).toHaveLength(0)
140
+ expect(queriesTo('api_keys', 'insert')).toHaveLength(1)
141
+ expect(result.apiKey.raw_key).toMatch(/^sk_[0-9a-f]{32}$/)
142
+ // Only the key mint is audited — no person.created event.
143
+ const events = vi.mocked(emitLog).mock.calls.map((c) => c[1])
144
+ expect(events).toEqual(['api_key.created'])
145
+ })
146
+
147
+ it('creates the first admin person (db-only) when none exists', async () => {
148
+ const result = await runBootstrap(db(), {})
149
+
150
+ expect(result.admin).toBe('created')
151
+ expect(result.authUserCreated).toBe(false)
152
+ expect(result.personEmail).toBe('admin@spine.local')
153
+
154
+ const row = insertedRow('people')
155
+ // Register-path (handle_new_auth_user) column parity.
156
+ expect(row.account_id).toBe('acct-spine')
157
+ expect(row.role_id).toBe('role-admin')
158
+ expect(row.type_id).toBe('type-person')
159
+ expect(row.status).toBe('active')
160
+ expect(row.is_active).toBe(true)
161
+ expect(row.auth_uid).toBeNull()
162
+ expect(row.email).toBe('admin@spine.local')
163
+ expect(row.full_name).toBe('admin')
164
+ expect(row.design_schema).toEqual({ fields: {} })
165
+ expect(supaState.createUser).not.toHaveBeenCalled()
166
+ expect(vi.mocked(emitLog).mock.calls.map((c) => c[1])).toEqual([
167
+ 'person.created',
168
+ 'api_key.created',
169
+ ])
170
+ })
171
+
172
+ it('creates a confirmed auth user + person when --email/--password are given', async () => {
173
+ supaState.createUser.mockResolvedValue({
174
+ data: { user: { id: 'auth-1' } },
175
+ error: null,
176
+ })
177
+
178
+ const result = await runBootstrap(db(), {
179
+ email: 'me@x.com',
180
+ password: 's3cret',
181
+ fullName: 'Me',
182
+ })
183
+
184
+ expect(supaState.createUser).toHaveBeenCalledWith({
185
+ email: 'me@x.com',
186
+ password: 's3cret',
187
+ email_confirm: true,
188
+ user_metadata: { full_name: 'Me' },
189
+ })
190
+ expect(result.authUserCreated).toBe(true)
191
+ const row = insertedRow('people')
192
+ // Register path: person id === auth user id, auth_uid === auth user id.
193
+ expect(row.id).toBe('auth-1')
194
+ expect(row.auth_uid).toBe('auth-1')
195
+ expect(row.email).toBe('me@x.com')
196
+ expect(row.full_name).toBe('Me')
197
+ })
198
+
199
+ it('rejects --password without --email before any DB work', async () => {
200
+ await expect(runBootstrap(db(), { password: 'x' })).rejects.toThrow('--password requires --email')
201
+ expect(supaState.history).toHaveLength(0)
202
+ })
203
+
204
+ it('fails clearly when the spine-system account seed is missing', async () => {
205
+ tables.account = null
206
+ await expect(runBootstrap(db(), {})).rejects.toThrow(/spine-system account not found/)
207
+ expect(queriesTo('api_keys', 'insert')).toHaveLength(0)
208
+ })
209
+ })
210
+
211
+ describe('bootstrap api key minting', () => {
212
+ it('stores only the hash — raw key is returned once and verifies', async () => {
213
+ const result = await runBootstrap(db(), {})
214
+
215
+ const keyRow = insertedRow('api_keys')
216
+ expect(keyRow.key_hash).toMatch(/^pbkdf2\$\d+\$/)
217
+ expect(keyRow.key_prefix).toBe(result.apiKey.raw_key.slice(0, 8))
218
+ expect(keyRow.raw_key).toBeUndefined()
219
+ expect(keyRow.key_value).toBeUndefined()
220
+ expect(verifyApiKey(result.apiKey.raw_key, keyRow.key_hash)).toBe(true)
221
+ expect(keyRow.is_active).toBe(true)
222
+ expect(keyRow.created_by).toBe(result.personId)
223
+ expect(keyRow.account_id).toBe('acct-spine')
224
+ })
225
+
226
+ it('defaults to the system_admin wildcard scope', async () => {
227
+ const result = await runBootstrap(db(), {})
228
+ expect(result.apiKey.scopes).toEqual(['*:*'])
229
+ expect(insertedRow('api_keys').scopes).toEqual(['*:*'])
230
+ })
231
+
232
+ it('honors repeated --scope flags for narrower keys', async () => {
233
+ const result = await runBootstrap(db(), { scopes: ['items:read', 'items:write'] })
234
+ expect(insertedRow('api_keys').scopes).toEqual(['items:read', 'items:write'])
235
+ expect(result.apiKey.scopes).toEqual(['items:read', 'items:write'])
236
+ })
237
+
238
+ it('maps the literal system_admin scope to *:*', async () => {
239
+ const result = await runBootstrap(db(), { scopes: ['system_admin'] })
240
+ expect(result.apiKey.scopes).toEqual(['*:*'])
241
+ })
242
+ })
@@ -0,0 +1,114 @@
1
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
2
+ import { hashApiKey } from '../../functions/_shared/hash-api-key'
3
+
4
+ const { mockFrom, mockLimit } = vi.hoisted(() => ({
5
+ mockFrom: vi.fn(),
6
+ mockLimit: vi.fn(),
7
+ }))
8
+
9
+ vi.mock('../../functions/_shared/index.ts', () => ({
10
+ adminDb: { from: mockFrom },
11
+ getUserDb: vi.fn(),
12
+ SYSTEM_PRINCIPAL: { id: 'system', type: 'system' },
13
+ }))
14
+
15
+ const ENV_KEYS = [
16
+ 'SUPABASE_URL',
17
+ 'SUPABASE_SERVICE_ROLE_KEY',
18
+ 'SPINE_CLI_API_KEY',
19
+ 'SPINE_CLI_JWT',
20
+ 'SPINE_CLI_ACCOUNT_ID',
21
+ ] as const
22
+
23
+ const savedEnv: Record<string, string | undefined> = {}
24
+
25
+ async function loadContext() {
26
+ vi.resetModules()
27
+ return await import('../../cli/context.ts')
28
+ }
29
+
30
+ beforeEach(() => {
31
+ vi.clearAllMocks()
32
+ for (const key of ENV_KEYS) savedEnv[key] = process.env[key]
33
+ process.env.SUPABASE_URL = 'https://example.supabase.co'
34
+ process.env.SUPABASE_SERVICE_ROLE_KEY = 'service-role-test-key'
35
+ delete process.env.SPINE_CLI_API_KEY
36
+ delete process.env.SPINE_CLI_JWT
37
+ delete process.env.SPINE_CLI_ACCOUNT_ID
38
+
39
+ mockFrom.mockReturnValue({
40
+ select: vi.fn(() => ({
41
+ eq: vi.fn(() => ({
42
+ eq: vi.fn(() => ({
43
+ order: vi.fn(() => ({ limit: mockLimit })),
44
+ })),
45
+ })),
46
+ })),
47
+ })
48
+ })
49
+
50
+ afterEach(() => {
51
+ for (const key of ENV_KEYS) {
52
+ if (savedEnv[key] === undefined) {
53
+ delete process.env[key]
54
+ } else {
55
+ process.env[key] = savedEnv[key]
56
+ }
57
+ }
58
+ })
59
+
60
+ describe('buildCliContext API key auth', () => {
61
+ it('returns a machine principal for a valid raw key', async () => {
62
+ const rawKey = 'sk_validrawkey0001'
63
+ const { key_hash } = hashApiKey(rawKey)
64
+ mockLimit.mockResolvedValue({
65
+ data: [{ id: 'key-id-1', account_id: 'acct-1', scopes: ['read'], key_hash, expires_at: null }],
66
+ error: null,
67
+ })
68
+ process.env.SPINE_CLI_API_KEY = rawKey
69
+
70
+ const { buildCliContext } = await loadContext()
71
+ const ctx = await buildCliContext()
72
+
73
+ expect(ctx.principal.type).toBe('machine')
74
+ expect(ctx.principal.id).toBe('key-id-1')
75
+ expect(ctx.principal.provenance.apiKeyId).toBe('key-id-1')
76
+ expect(ctx.principal.provenance.sourceType).toBe('api_key')
77
+ expect(ctx.accountId).toBe('acct-1')
78
+ expect(ctx.requestId).toBeTruthy()
79
+ expect(mockFrom).toHaveBeenCalledWith('api_keys')
80
+ })
81
+
82
+ it('rejects a wrong key sharing the same prefix', async () => {
83
+ const { key_hash } = hashApiKey('sk_wrongxx_other')
84
+ mockLimit.mockResolvedValue({
85
+ data: [{ id: 'key-id-1', account_id: 'acct-1', scopes: [], key_hash, expires_at: null }],
86
+ error: null,
87
+ })
88
+ process.env.SPINE_CLI_API_KEY = 'sk_wrongxx_guess'
89
+
90
+ const { buildCliContext } = await loadContext()
91
+ await expect(buildCliContext()).rejects.toThrow('Invalid or inactive SPINE_CLI_API_KEY')
92
+ })
93
+
94
+ it('skips expired rows and rejects when only expired keys match', async () => {
95
+ const rawKey = 'sk_expiredkey001'
96
+ const { key_hash } = hashApiKey(rawKey)
97
+ mockLimit.mockResolvedValue({
98
+ data: [{ id: 'key-id-1', account_id: 'acct-1', scopes: [], key_hash, expires_at: '2000-01-01T00:00:00Z' }],
99
+ error: null,
100
+ })
101
+ process.env.SPINE_CLI_API_KEY = rawKey
102
+
103
+ const { buildCliContext } = await loadContext()
104
+ await expect(buildCliContext()).rejects.toThrow('Invalid or inactive SPINE_CLI_API_KEY')
105
+ })
106
+
107
+ it('rejects when no active keys match the prefix', async () => {
108
+ mockLimit.mockResolvedValue({ data: [], error: null })
109
+ process.env.SPINE_CLI_API_KEY = 'sk_nomatch_00000'
110
+
111
+ const { buildCliContext } = await loadContext()
112
+ await expect(buildCliContext()).rejects.toThrow('Invalid or inactive SPINE_CLI_API_KEY')
113
+ })
114
+ })
@@ -0,0 +1,38 @@
1
+ import { describe, it, expect, vi } from 'vitest'
2
+
3
+ const principalRef = vi.hoisted(() => ({ principal: null as any }))
4
+
5
+ vi.mock('../../functions/_shared/middleware', () => ({
6
+ createHandler: (fn: any) => async () =>
7
+ fn({ principal: principalRef.principal, requestId: 'req-1', accountId: 'acct-1' }, {}),
8
+ }))
9
+
10
+ import { handler } from '../../functions/debug-auth'
11
+
12
+ const event = (method?: string) => ({ queryStringParameters: method ? { method } : {} })
13
+
14
+ describe('debug-auth system_admin gate', () => {
15
+ it('denies a non-admin principal with statusCode 403', async () => {
16
+ principalRef.principal = { type: 'person', id: 'p1', roles: [{ slug: 'member' }] }
17
+ await expect(handler(event(), {})).rejects.toMatchObject({ statusCode: 403 })
18
+ })
19
+
20
+ it('denies an unauthenticated request (no principal)', async () => {
21
+ principalRef.principal = null
22
+ await expect(handler(event(), {})).rejects.toMatchObject({ statusCode: 403 })
23
+ })
24
+
25
+ it('returns debug data for a system_admin principal', async () => {
26
+ principalRef.principal = { type: 'person', id: 'p1', roles: [{ slug: 'system_admin' }] }
27
+ const res = await handler(event('debug'), {})
28
+ expect(res.data.message).toBe('Debug auth endpoint')
29
+ expect(res.data.hasPrincipal).toBe(true)
30
+ })
31
+
32
+ it('returns tokenValid for testJwt with a system_admin principal', async () => {
33
+ principalRef.principal = { type: 'person', id: 'p1', roles: [{ slug: 'system_admin' }] }
34
+ const res = await handler(event('testJwt'), {})
35
+ expect(res.data.tokenValid).toBe(true)
36
+ expect(res.data.principal.id).toBe('p1')
37
+ })
38
+ })