@maestro-js/agent-skills 1.0.0-alpha.2 → 1.0.0-alpha.21

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 (691) hide show
  1. package/dist/bin.js +19 -0
  2. package/package.json +8 -7
  3. package/{dist → skills}/choosing-an-npm-package/SKILL.md +5 -4
  4. package/skills/iconify/SKILL.md +82 -0
  5. package/skills/iconify/scripts/iconify.js +111 -0
  6. package/skills/iso-fns/SKILL.md +137 -0
  7. package/skills/iso-fns/references/api_reference.md +435 -0
  8. package/skills/maestro-architecture/SKILL.md +552 -0
  9. package/skills/maestro-examples/SKILL.md +140 -0
  10. package/skills/maestro-examples/references/cadence/cadence-web/.auth/user.json +15 -0
  11. package/skills/maestro-examples/references/cadence/cadence-web/app/app.css +112 -0
  12. package/skills/maestro-examples/references/cadence/cadence-web/app/components/auth-layout.tsx +39 -0
  13. package/skills/maestro-examples/references/cadence/cadence-web/app/components/back-link.tsx +24 -0
  14. package/skills/maestro-examples/references/cadence/cadence-web/app/components/button-group.tsx +78 -0
  15. package/skills/maestro-examples/references/cadence/cadence-web/app/components/button-link.tsx +77 -0
  16. package/skills/maestro-examples/references/cadence/cadence-web/app/components/button.tsx +139 -0
  17. package/skills/maestro-examples/references/cadence/cadence-web/app/components/checkbox.tsx +210 -0
  18. package/skills/maestro-examples/references/cadence/cadence-web/app/components/chip.tsx +161 -0
  19. package/skills/maestro-examples/references/cadence/cadence-web/app/components/container.tsx +85 -0
  20. package/skills/maestro-examples/references/cadence/cadence-web/app/components/date-range.tsx +141 -0
  21. package/skills/maestro-examples/references/cadence/cadence-web/app/components/date-time-picker.tsx +199 -0
  22. package/skills/maestro-examples/references/cadence/cadence-web/app/components/empty-state.tsx +19 -0
  23. package/skills/maestro-examples/references/cadence/cadence-web/app/components/form-page.tsx +41 -0
  24. package/skills/maestro-examples/references/cadence/cadence-web/app/components/form.tsx +106 -0
  25. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/animated-popover.tsx +27 -0
  26. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/button-context.ts +13 -0
  27. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/calendar-month-year-picker.tsx +283 -0
  28. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/form-field.tsx +231 -0
  29. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/get-button-classes.ts +141 -0
  30. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/headless-button.tsx +39 -0
  31. package/skills/maestro-examples/references/cadence/cadence-web/app/components/icon.tsx +29 -0
  32. package/skills/maestro-examples/references/cadence/cadence-web/app/components/inline-alert.tsx +57 -0
  33. package/skills/maestro-examples/references/cadence/cadence-web/app/components/interaction-form.tsx +87 -0
  34. package/skills/maestro-examples/references/cadence/cadence-web/app/components/menu.tsx +189 -0
  35. package/skills/maestro-examples/references/cadence/cadence-web/app/components/optional-link.tsx +18 -0
  36. package/skills/maestro-examples/references/cadence/cadence-web/app/components/page-header.tsx +19 -0
  37. package/skills/maestro-examples/references/cadence/cadence-web/app/components/rich-text-editor.tsx +352 -0
  38. package/skills/maestro-examples/references/cadence/cadence-web/app/components/select.tsx +219 -0
  39. package/skills/maestro-examples/references/cadence/cadence-web/app/components/spinner.tsx +19 -0
  40. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/headless-templated-row-table.ts +553 -0
  41. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/index.tsx +44 -0
  42. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/server-table.ts +146 -0
  43. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-actions.tsx +79 -0
  44. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-container.tsx +176 -0
  45. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-container.type-test.ts +158 -0
  46. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-filters/date-range-filter.tsx +230 -0
  47. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-filters/select-filter.tsx +214 -0
  48. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-filters/sort.tsx +88 -0
  49. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-primitives.tsx +229 -0
  50. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-toolbar.tsx +303 -0
  51. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-types.ts +64 -0
  52. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/use-client-table.ts +160 -0
  53. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/use-client-table.type-test.ts +220 -0
  54. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/use-server-table.ts +195 -0
  55. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/use-server-table.type-test.ts +177 -0
  56. package/skills/maestro-examples/references/cadence/cadence-web/app/components/tag-editor.tsx +53 -0
  57. package/skills/maestro-examples/references/cadence/cadence-web/app/components/tag-field.tsx +253 -0
  58. package/skills/maestro-examples/references/cadence/cadence-web/app/components/text-field.tsx +147 -0
  59. package/skills/maestro-examples/references/cadence/cadence-web/app/components/toast.tsx +182 -0
  60. package/skills/maestro-examples/references/cadence/cadence-web/app/components/top-nav.tsx +175 -0
  61. package/skills/maestro-examples/references/cadence/cadence-web/app/entry.client.tsx +21 -0
  62. package/skills/maestro-examples/references/cadence/cadence-web/app/entry.server.tsx +13 -0
  63. package/skills/maestro-examples/references/cadence/cadence-web/app/features/csrf-middleware.server.ts +17 -0
  64. package/skills/maestro-examples/references/cadence/cadence-web/app/features/custom-error-status-code-middleware.server.ts +31 -0
  65. package/skills/maestro-examples/references/cadence/cadence-web/app/features/rate-limiting-middleware.server.ts +36 -0
  66. package/skills/maestro-examples/references/cadence/cadence-web/app/features/redirect-with-toast.server.ts +14 -0
  67. package/skills/maestro-examples/references/cadence/cadence-web/app/features/request-context.server.ts +40 -0
  68. package/skills/maestro-examples/references/cadence/cadence-web/app/features/security-headers-middleware.server.ts +10 -0
  69. package/skills/maestro-examples/references/cadence/cadence-web/app/icons/types.ts +36 -0
  70. package/skills/maestro-examples/references/cadence/cadence-web/app/root.tsx +208 -0
  71. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/_index.tsx +5 -0
  72. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/activity.tsx +124 -0
  73. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/archive.tsx +187 -0
  74. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/auth.forgot-password.tsx +108 -0
  75. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/auth.login.tsx +132 -0
  76. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/auth.logout.tsx +17 -0
  77. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/auth.register.tsx +172 -0
  78. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/auth.reset-password.tsx +137 -0
  79. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/contacts.$id.edit.tsx +89 -0
  80. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/contacts.$id.tsx +521 -0
  81. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/contacts.new.tsx +56 -0
  82. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/contacts.tsx +183 -0
  83. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/settings.tsx +158 -0
  84. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/users.tsx +263 -0
  85. package/skills/maestro-examples/references/cadence/cadence-web/app/routes.ts +4 -0
  86. package/skills/maestro-examples/references/cadence/cadence-web/app/services.server.ts +1 -0
  87. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/colors.ts +47 -0
  88. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/compose-event-handlers.ts +13 -0
  89. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/compose-refs.ts +35 -0
  90. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/format-date.ts +10 -0
  91. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/overridable-component-helper.ts +31 -0
  92. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/sanitize-html.ts +16 -0
  93. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/tw.ts +16 -0
  94. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-hydrated.ts +12 -0
  95. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-prevent-default.ts +30 -0
  96. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-query-state.ts +629 -0
  97. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-render-props.ts +42 -0
  98. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-spin-delay.ts +27 -0
  99. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-stable-accessor.ts +14 -0
  100. package/skills/maestro-examples/references/cadence/cadence-web/instrument.server.mjs +29 -0
  101. package/skills/maestro-examples/references/cadence/cadence-web/package.json +60 -0
  102. package/skills/maestro-examples/references/cadence/cadence-web/playwright.config.ts +39 -0
  103. package/skills/maestro-examples/references/cadence/cadence-web/react-router.config.ts +12 -0
  104. package/skills/maestro-examples/references/cadence/cadence-web/tailwind.config.ts +7 -0
  105. package/skills/maestro-examples/references/cadence/cadence-web/tests/activity/filter-activity.spec.ts +93 -0
  106. package/skills/maestro-examples/references/cadence/cadence-web/tests/activity/recent-activity.spec.ts +70 -0
  107. package/skills/maestro-examples/references/cadence/cadence-web/tests/archive/archive-view.spec.ts +62 -0
  108. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth/login-invalid.spec.ts +68 -0
  109. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth/login-valid.spec.ts +45 -0
  110. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth/logout.spec.ts +46 -0
  111. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth/password-reset.spec.ts +105 -0
  112. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth/register.spec.ts +39 -0
  113. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth.setup.ts +48 -0
  114. package/skills/maestro-examples/references/cadence/cadence-web/tests/authorization/member-ownership.spec.ts +104 -0
  115. package/skills/maestro-examples/references/cadence/cadence-web/tests/authorization/viewer-read-only.spec.ts +103 -0
  116. package/skills/maestro-examples/references/cadence/cadence-web/tests/constants.ts +11 -0
  117. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/archive-restore.spec.ts +77 -0
  118. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/create-contact.spec.ts +56 -0
  119. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/delete-contact.spec.ts +53 -0
  120. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/edit-contact.spec.ts +60 -0
  121. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/filter-by-last-contacted.spec.ts +85 -0
  122. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/filter-by-tag.spec.ts +68 -0
  123. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/global-search.spec.ts +57 -0
  124. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/sort-contacts.spec.ts +60 -0
  125. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/tags.spec.ts +85 -0
  126. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/view-detail.spec.ts +58 -0
  127. package/skills/maestro-examples/references/cadence/cadence-web/tests/interactions/delete-interaction.spec.ts +59 -0
  128. package/skills/maestro-examples/references/cadence/cadence-web/tests/interactions/edit-interaction.spec.ts +68 -0
  129. package/skills/maestro-examples/references/cadence/cadence-web/tests/interactions/log-email.spec.ts +57 -0
  130. package/skills/maestro-examples/references/cadence/cadence-web/tests/interactions/log-note.spec.ts +56 -0
  131. package/skills/maestro-examples/references/cadence/cadence-web/tests/interactions/rich-text-formatting.spec.ts +97 -0
  132. package/skills/maestro-examples/references/cadence/cadence-web/tests/organization/delete.spec.ts +70 -0
  133. package/skills/maestro-examples/references/cadence/cadence-web/tests/organization/edit-name.spec.ts +51 -0
  134. package/skills/maestro-examples/references/cadence/cadence-web/tests/users/change-role.spec.ts +62 -0
  135. package/skills/maestro-examples/references/cadence/cadence-web/tests/users/invite-user.spec.ts +56 -0
  136. package/skills/maestro-examples/references/cadence/cadence-web/tests/users/remove-user.spec.ts +58 -0
  137. package/skills/maestro-examples/references/cadence/cadence-web/tsconfig.json +22 -0
  138. package/skills/maestro-examples/references/cadence/cadence-web/vite.config.ts +37 -0
  139. package/skills/maestro-examples/references/cadence/config/agent-container.ts +4 -0
  140. package/skills/maestro-examples/references/cadence/config/cadence-web.ts +12 -0
  141. package/skills/maestro-examples/references/cadence/config/db-migrate.ts +9 -0
  142. package/skills/maestro-examples/references/cadence/config/queue-processor.ts +11 -0
  143. package/skills/maestro-examples/references/cadence/config/services.ts +16 -0
  144. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000001_organizations-and-users.ts +16 -0
  145. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000002_contacts.ts +16 -0
  146. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000003_interactions.ts +16 -0
  147. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000004_remember-me-tokens.ts +16 -0
  148. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000005_password-reset-tokens.ts +16 -0
  149. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000006_queue-and-recurring-jobs.ts +16 -0
  150. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000001_organizations-and-users-down.sql +2 -0
  151. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000001_organizations-and-users-up.sql +24 -0
  152. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000002_contacts-down.sql +1 -0
  153. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000002_contacts-up.sql +16 -0
  154. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000003_interactions-down.sql +1 -0
  155. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000003_interactions-up.sql +15 -0
  156. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000004_remember-me-tokens-down.sql +1 -0
  157. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000004_remember-me-tokens-up.sql +12 -0
  158. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000005_password-reset-tokens-down.sql +1 -0
  159. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000005_password-reset-tokens-up.sql +11 -0
  160. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000006_queue-and-recurring-jobs-down.sql +2 -0
  161. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000006_queue-and-recurring-jobs-up.sql +21 -0
  162. package/skills/maestro-examples/references/cadence/package.json +17 -0
  163. package/skills/maestro-examples/references/cadence/packages/schemas/package.json +17 -0
  164. package/skills/maestro-examples/references/cadence/packages/schemas/src/contact/index.ts +57 -0
  165. package/skills/maestro-examples/references/cadence/packages/schemas/src/index.ts +4 -0
  166. package/skills/maestro-examples/references/cadence/packages/schemas/src/interaction/index.ts +45 -0
  167. package/skills/maestro-examples/references/cadence/packages/schemas/src/organization/index.ts +32 -0
  168. package/skills/maestro-examples/references/cadence/packages/schemas/src/user/index.ts +69 -0
  169. package/skills/maestro-examples/references/cadence/packages/schemas/tsconfig.json +9 -0
  170. package/skills/maestro-examples/references/cadence/packages/services/package.json +43 -0
  171. package/skills/maestro-examples/references/cadence/packages/services/run-tests.ts +59 -0
  172. package/skills/maestro-examples/references/cadence/packages/services/src/auth/auth-db-provider.ts +202 -0
  173. package/skills/maestro-examples/references/cadence/packages/services/src/auth/auth-use-cases.ts +155 -0
  174. package/skills/maestro-examples/references/cadence/packages/services/src/auth/index.ts +17 -0
  175. package/skills/maestro-examples/references/cadence/packages/services/src/auth/profile-db-provider.ts +17 -0
  176. package/skills/maestro-examples/references/cadence/packages/services/src/contact/contact-db-provider.test.ts +120 -0
  177. package/skills/maestro-examples/references/cadence/packages/services/src/contact/contact-db-provider.ts +145 -0
  178. package/skills/maestro-examples/references/cadence/packages/services/src/contact/contact-use-cases.ts +196 -0
  179. package/skills/maestro-examples/references/cadence/packages/services/src/contact/index.ts +29 -0
  180. package/skills/maestro-examples/references/cadence/packages/services/src/index.ts +23 -0
  181. package/skills/maestro-examples/references/cadence/packages/services/src/interaction/index.ts +25 -0
  182. package/skills/maestro-examples/references/cadence/packages/services/src/interaction/interaction-db-provider.test.ts +128 -0
  183. package/skills/maestro-examples/references/cadence/packages/services/src/interaction/interaction-db-provider.ts +98 -0
  184. package/skills/maestro-examples/references/cadence/packages/services/src/interaction/interaction-use-cases.ts +171 -0
  185. package/skills/maestro-examples/references/cadence/packages/services/src/maestro.ts +218 -0
  186. package/skills/maestro-examples/references/cadence/packages/services/src/organization/index.ts +8 -0
  187. package/skills/maestro-examples/references/cadence/packages/services/src/organization/organization-db-provider.test.ts +53 -0
  188. package/skills/maestro-examples/references/cadence/packages/services/src/organization/organization-db-provider.ts +60 -0
  189. package/skills/maestro-examples/references/cadence/packages/services/src/organization/organization-use-cases.ts +88 -0
  190. package/skills/maestro-examples/references/cadence/packages/services/src/permissions.ts +28 -0
  191. package/skills/maestro-examples/references/cadence/packages/services/src/testing/contact-seed.ts +30 -0
  192. package/skills/maestro-examples/references/cadence/packages/services/src/testing/index.ts +13 -0
  193. package/skills/maestro-examples/references/cadence/packages/services/src/testing/interaction-seed.ts +29 -0
  194. package/skills/maestro-examples/references/cadence/packages/services/src/testing/organization-seed.ts +25 -0
  195. package/skills/maestro-examples/references/cadence/packages/services/src/testing/seed-pipe.ts +38 -0
  196. package/skills/maestro-examples/references/cadence/packages/services/src/testing/user-seed.ts +27 -0
  197. package/skills/maestro-examples/references/cadence/packages/services/src/user/index.ts +27 -0
  198. package/skills/maestro-examples/references/cadence/packages/services/src/user/user-db-provider.test.ts +100 -0
  199. package/skills/maestro-examples/references/cadence/packages/services/src/user/user-db-provider.ts +69 -0
  200. package/skills/maestro-examples/references/cadence/packages/services/src/user/user-use-cases.ts +162 -0
  201. package/skills/maestro-examples/references/cadence/packages/services/tsconfig.json +9 -0
  202. package/skills/maestro-examples/references/cadence/scripts/foreign-key-delete-behavior.ts +106 -0
  203. package/skills/maestro-examples/references/cadence/specs/app.md +72 -0
  204. package/skills/maestro-examples/references/cadence/specs/data-models.md +80 -0
  205. package/skills/maestro-examples/references/cadence/specs/multi-tenant-security.md +239 -0
  206. package/skills/maestro-examples/references/cadence/specs/rich-text-editor.md +108 -0
  207. package/skills/maestro-examples/references/cadence/specs/table.md +151 -0
  208. package/skills/maestro-examples/references/cadence/specs/use-cases.md +62 -0
  209. package/skills/maestro-examples/references/cadence/tsconfig.json +29 -0
  210. package/skills/maestro-examples/references/chorus/chorus-web/app/app.css +152 -0
  211. package/skills/maestro-examples/references/chorus/chorus-web/app/components/alert-dialog.tsx +153 -0
  212. package/skills/maestro-examples/references/chorus/chorus-web/app/components/avatar.tsx +57 -0
  213. package/skills/maestro-examples/references/chorus/chorus-web/app/components/button-group.tsx +78 -0
  214. package/skills/maestro-examples/references/chorus/chorus-web/app/components/button-link.tsx +77 -0
  215. package/skills/maestro-examples/references/chorus/chorus-web/app/components/button.tsx +139 -0
  216. package/skills/maestro-examples/references/chorus/chorus-web/app/components/channel-card.tsx +40 -0
  217. package/skills/maestro-examples/references/chorus/chorus-web/app/components/checkbox-group.tsx +175 -0
  218. package/skills/maestro-examples/references/chorus/chorus-web/app/components/checkbox.tsx +210 -0
  219. package/skills/maestro-examples/references/chorus/chorus-web/app/components/chip.tsx +161 -0
  220. package/skills/maestro-examples/references/chorus/chorus-web/app/components/container.tsx +85 -0
  221. package/skills/maestro-examples/references/chorus/chorus-web/app/components/date-picker.tsx +214 -0
  222. package/skills/maestro-examples/references/chorus/chorus-web/app/components/date-time-picker.tsx +199 -0
  223. package/skills/maestro-examples/references/chorus/chorus-web/app/components/dialog.tsx +114 -0
  224. package/skills/maestro-examples/references/chorus/chorus-web/app/components/enum-chip.tsx +33 -0
  225. package/skills/maestro-examples/references/chorus/chorus-web/app/components/file-input.tsx +248 -0
  226. package/skills/maestro-examples/references/chorus/chorus-web/app/components/form.tsx +106 -0
  227. package/skills/maestro-examples/references/chorus/chorus-web/app/components/headless-file-input.tsx +365 -0
  228. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/animated-popover.tsx +27 -0
  229. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/button-context.ts +13 -0
  230. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/calendar-month-year-picker.tsx +283 -0
  231. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/form-field.tsx +231 -0
  232. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/get-button-classes.ts +141 -0
  233. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/headless-button.tsx +39 -0
  234. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/pdf-dist.client.ts +9 -0
  235. package/skills/maestro-examples/references/chorus/chorus-web/app/components/icon.tsx +29 -0
  236. package/skills/maestro-examples/references/chorus/chorus-web/app/components/image-grid.tsx +96 -0
  237. package/skills/maestro-examples/references/chorus/chorus-web/app/components/image-input.tsx +268 -0
  238. package/skills/maestro-examples/references/chorus/chorus-web/app/components/inline-alert.tsx +57 -0
  239. package/skills/maestro-examples/references/chorus/chorus-web/app/components/like-button.tsx +48 -0
  240. package/skills/maestro-examples/references/chorus/chorus-web/app/components/menu.tsx +189 -0
  241. package/skills/maestro-examples/references/chorus/chorus-web/app/components/pdf-input.tsx +252 -0
  242. package/skills/maestro-examples/references/chorus/chorus-web/app/components/pdf.tsx +89 -0
  243. package/skills/maestro-examples/references/chorus/chorus-web/app/components/post-card.tsx +147 -0
  244. package/skills/maestro-examples/references/chorus/chorus-web/app/components/post-composer.tsx +166 -0
  245. package/skills/maestro-examples/references/chorus/chorus-web/app/components/radio-group.tsx +115 -0
  246. package/skills/maestro-examples/references/chorus/chorus-web/app/components/select.tsx +219 -0
  247. package/skills/maestro-examples/references/chorus/chorus-web/app/components/spinner.tsx +19 -0
  248. package/skills/maestro-examples/references/chorus/chorus-web/app/components/tag-field.tsx +253 -0
  249. package/skills/maestro-examples/references/chorus/chorus-web/app/components/text-area.tsx +151 -0
  250. package/skills/maestro-examples/references/chorus/chorus-web/app/components/text-field.tsx +147 -0
  251. package/skills/maestro-examples/references/chorus/chorus-web/app/components/toast.tsx +179 -0
  252. package/skills/maestro-examples/references/chorus/chorus-web/app/entry.client.tsx +21 -0
  253. package/skills/maestro-examples/references/chorus/chorus-web/app/entry.server.tsx +12 -0
  254. package/skills/maestro-examples/references/chorus/chorus-web/app/features/csrf-hidden-input.tsx +6 -0
  255. package/skills/maestro-examples/references/chorus/chorus-web/app/features/csrf-middleware.server.ts +17 -0
  256. package/skills/maestro-examples/references/chorus/chorus-web/app/features/custom-error-status-code-middleware.server.ts +18 -0
  257. package/skills/maestro-examples/references/chorus/chorus-web/app/features/rate-limiting-middleware.server.ts +36 -0
  258. package/skills/maestro-examples/references/chorus/chorus-web/app/features/redirect-with-toast.server.ts +14 -0
  259. package/skills/maestro-examples/references/chorus/chorus-web/app/features/request-context.server.ts +40 -0
  260. package/skills/maestro-examples/references/chorus/chorus-web/app/features/security-headers-middleware.server.ts +10 -0
  261. package/skills/maestro-examples/references/chorus/chorus-web/app/icons/types.ts +26 -0
  262. package/skills/maestro-examples/references/chorus/chorus-web/app/root.tsx +164 -0
  263. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_auth/forgot-password.tsx +90 -0
  264. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_auth/login.tsx +104 -0
  265. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_auth/logout.tsx +44 -0
  266. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_auth/reset-password.tsx +130 -0
  267. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_auth/signup.tsx +91 -0
  268. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_browse/_layout.tsx +36 -0
  269. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_browse/c.new.tsx +47 -0
  270. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_browse/index.tsx +3 -0
  271. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/api/hide-post.$postId.tsx +30 -0
  272. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/api/like.$postId.tsx +22 -0
  273. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug/_layout.tsx +108 -0
  274. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug/post.new.tsx +59 -0
  275. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug.edit.tsx +53 -0
  276. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug.manage/_layout.tsx +123 -0
  277. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug.manage/add-moderator.tsx +48 -0
  278. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug.manage/transfer-ownership.tsx +71 -0
  279. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug.post.$postId.tsx +119 -0
  280. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/files.$.tsx +22 -0
  281. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/health.tsx +3 -0
  282. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/settings.tsx +128 -0
  283. package/skills/maestro-examples/references/chorus/chorus-web/app/routes.ts +4 -0
  284. package/skills/maestro-examples/references/chorus/chorus-web/app/services.server.ts +1 -0
  285. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/colors.ts +47 -0
  286. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/compose-refs.ts +35 -0
  287. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/enum-colors.ts +4 -0
  288. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/file-input.ts +52 -0
  289. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/tw.ts +16 -0
  290. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-element-size.ts +35 -0
  291. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-number-input.ts +143 -0
  292. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-pagination.ts +41 -0
  293. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-prevent-default.ts +30 -0
  294. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-profile.ts +7 -0
  295. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-render-props.ts +42 -0
  296. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-spin-delay.ts +27 -0
  297. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-stable-accessor.ts +14 -0
  298. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-tab-indicator.ts +107 -0
  299. package/skills/maestro-examples/references/chorus/chorus-web/environment.d.ts +15 -0
  300. package/skills/maestro-examples/references/chorus/chorus-web/instrument.server.mjs +29 -0
  301. package/skills/maestro-examples/references/chorus/chorus-web/package.json +54 -0
  302. package/skills/maestro-examples/references/chorus/chorus-web/playwright.config.ts +39 -0
  303. package/skills/maestro-examples/references/chorus/chorus-web/react-router.config.ts +12 -0
  304. package/skills/maestro-examples/references/chorus/chorus-web/tests/auth-landing.test.ts +8 -0
  305. package/skills/maestro-examples/references/chorus/chorus-web/tests/auth-login.test.ts +40 -0
  306. package/skills/maestro-examples/references/chorus/chorus-web/tests/auth-logout.test.ts +8 -0
  307. package/skills/maestro-examples/references/chorus/chorus-web/tests/auth-signup.test.ts +15 -0
  308. package/skills/maestro-examples/references/chorus/chorus-web/tests/auth.setup.ts +42 -0
  309. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-browse.test.ts +43 -0
  310. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-create.test.ts +34 -0
  311. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-edit.test.ts +33 -0
  312. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-manage-moderators.test.ts +59 -0
  313. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-manage-permissions.test.ts +55 -0
  314. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-transfer.test.ts +47 -0
  315. package/skills/maestro-examples/references/chorus/chorus-web/tests/constants.ts +7 -0
  316. package/skills/maestro-examples/references/chorus/chorus-web/tests/forgot-password.test.ts +33 -0
  317. package/skills/maestro-examples/references/chorus/chorus-web/tests/hide-post-author.test.ts +62 -0
  318. package/skills/maestro-examples/references/chorus/chorus-web/tests/hide-post-nonauthor.test.ts +36 -0
  319. package/skills/maestro-examples/references/chorus/chorus-web/tests/like-toggle.test.ts +60 -0
  320. package/skills/maestro-examples/references/chorus/chorus-web/tests/like-unauth.test.ts +37 -0
  321. package/skills/maestro-examples/references/chorus/chorus-web/tests/post-create.test.ts +30 -0
  322. package/skills/maestro-examples/references/chorus/chorus-web/tests/post-listing.test.ts +33 -0
  323. package/skills/maestro-examples/references/chorus/chorus-web/tests/post-reply.test.ts +48 -0
  324. package/skills/maestro-examples/references/chorus/chorus-web/tests/post-view-unauth.test.ts +37 -0
  325. package/skills/maestro-examples/references/chorus/chorus-web/tests/settings-duplicate.test.ts +28 -0
  326. package/skills/maestro-examples/references/chorus/chorus-web/tests/settings-update.test.ts +34 -0
  327. package/skills/maestro-examples/references/chorus/chorus-web/tests/settings-view.test.ts +17 -0
  328. package/skills/maestro-examples/references/chorus/chorus-web/tests/signup-validation.test.ts +51 -0
  329. package/skills/maestro-examples/references/chorus/chorus-web/tsconfig.json +14 -0
  330. package/skills/maestro-examples/references/chorus/chorus-web/vite.config.ts +38 -0
  331. package/skills/maestro-examples/references/chorus/config/app-a.ts +7 -0
  332. package/skills/maestro-examples/references/chorus/config/chorus-web.ts +7 -0
  333. package/skills/maestro-examples/references/chorus/config/db-migrate.ts +9 -0
  334. package/skills/maestro-examples/references/chorus/config/queue-processor.ts +7 -0
  335. package/skills/maestro-examples/references/chorus/config/services.ts +15 -0
  336. package/skills/maestro-examples/references/chorus/infrastructure/cdk/index.ts +60 -0
  337. package/skills/maestro-examples/references/chorus/infrastructure/cdk.context.json +5 -0
  338. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260303005902_init_authentication.ts +16 -0
  339. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260308234835_add-maestro-queue-table.ts +16 -0
  340. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315051819_channels.ts +16 -0
  341. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315052202_channel-moderators.ts +16 -0
  342. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315052539_posts.ts +16 -0
  343. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315052734_post-images.ts +16 -0
  344. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315053110_likes.ts +16 -0
  345. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260303005902_init_authentication-down.sql +3 -0
  346. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260303005902_init_authentication-up.sql +40 -0
  347. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260308234835_add-maestro-queue-table-down.sql +3 -0
  348. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260308234835_add-maestro-queue-table-up.sql +23 -0
  349. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315051819_channels-down.sql +1 -0
  350. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315051819_channels-up.sql +11 -0
  351. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052202_channel-moderators-down.sql +1 -0
  352. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052202_channel-moderators-up.sql +7 -0
  353. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052539_posts-down.sql +1 -0
  354. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052539_posts-up.sql +14 -0
  355. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052734_post-images-down.sql +1 -0
  356. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052734_post-images-up.sql +7 -0
  357. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315053110_likes-down.sql +1 -0
  358. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315053110_likes-up.sql +8 -0
  359. package/skills/maestro-examples/references/chorus/infrastructure/package.json +20 -0
  360. package/skills/maestro-examples/references/chorus/infrastructure/tsconfig.json +8 -0
  361. package/skills/maestro-examples/references/chorus/package.json +17 -0
  362. package/skills/maestro-examples/references/chorus/packages/email-templates/other/generate-email-modules.ts +22 -0
  363. package/skills/maestro-examples/references/chorus/packages/email-templates/other/generate-email-previews.ts +18 -0
  364. package/skills/maestro-examples/references/chorus/packages/email-templates/package.json +27 -0
  365. package/skills/maestro-examples/references/chorus/packages/email-templates/src/components/button.tsx +19 -0
  366. package/skills/maestro-examples/references/chorus/packages/email-templates/src/components/root-container.tsx +29 -0
  367. package/skills/maestro-examples/references/chorus/packages/email-templates/src/components/tailwind-wrapper.tsx +113 -0
  368. package/skills/maestro-examples/references/chorus/packages/email-templates/src/email-modules.ts +9 -0
  369. package/skills/maestro-examples/references/chorus/packages/email-templates/src/emails/password-reset.tsx +41 -0
  370. package/skills/maestro-examples/references/chorus/packages/email-templates/src/index.ts +3 -0
  371. package/skills/maestro-examples/references/chorus/packages/email-templates/src/render-email-template.ts +24 -0
  372. package/skills/maestro-examples/references/chorus/packages/email-templates/src/utils/tw.ts +5 -0
  373. package/skills/maestro-examples/references/chorus/packages/email-templates/tsconfig.json +11 -0
  374. package/skills/maestro-examples/references/chorus/packages/schemas/package.json +17 -0
  375. package/skills/maestro-examples/references/chorus/packages/schemas/src/channel/index.ts +41 -0
  376. package/skills/maestro-examples/references/chorus/packages/schemas/src/index.ts +4 -0
  377. package/skills/maestro-examples/references/chorus/packages/schemas/src/like/index.ts +16 -0
  378. package/skills/maestro-examples/references/chorus/packages/schemas/src/post/index.ts +44 -0
  379. package/skills/maestro-examples/references/chorus/packages/schemas/src/profile/index.ts +80 -0
  380. package/skills/maestro-examples/references/chorus/packages/schemas/tsconfig.json +9 -0
  381. package/skills/maestro-examples/references/chorus/packages/services/environment.d.ts +7 -0
  382. package/skills/maestro-examples/references/chorus/packages/services/package.json +47 -0
  383. package/skills/maestro-examples/references/chorus/packages/services/run-tests.ts +59 -0
  384. package/skills/maestro-examples/references/chorus/packages/services/src/auth/auth-use-cases.ts +178 -0
  385. package/skills/maestro-examples/references/chorus/packages/services/src/auth/authenticatable-db-provider.ts +59 -0
  386. package/skills/maestro-examples/references/chorus/packages/services/src/auth/index.ts +29 -0
  387. package/skills/maestro-examples/references/chorus/packages/services/src/auth/password-reset-token-db-provider.ts +58 -0
  388. package/skills/maestro-examples/references/chorus/packages/services/src/auth/remember-me-token-db-provider.ts +82 -0
  389. package/skills/maestro-examples/references/chorus/packages/services/src/channel/channel-db-provider.test.ts +85 -0
  390. package/skills/maestro-examples/references/chorus/packages/services/src/channel/channel-db-provider.ts +158 -0
  391. package/skills/maestro-examples/references/chorus/packages/services/src/channel/channel-use-cases.ts +303 -0
  392. package/skills/maestro-examples/references/chorus/packages/services/src/channel/index.ts +29 -0
  393. package/skills/maestro-examples/references/chorus/packages/services/src/index.ts +21 -0
  394. package/skills/maestro-examples/references/chorus/packages/services/src/like/index.ts +6 -0
  395. package/skills/maestro-examples/references/chorus/packages/services/src/like/like-db-provider.test.ts +47 -0
  396. package/skills/maestro-examples/references/chorus/packages/services/src/like/like-db-provider.ts +53 -0
  397. package/skills/maestro-examples/references/chorus/packages/services/src/like/like-use-cases.ts +31 -0
  398. package/skills/maestro-examples/references/chorus/packages/services/src/maestro.ts +215 -0
  399. package/skills/maestro-examples/references/chorus/packages/services/src/permissions.ts +16 -0
  400. package/skills/maestro-examples/references/chorus/packages/services/src/post/index.ts +25 -0
  401. package/skills/maestro-examples/references/chorus/packages/services/src/post/post-db-provider.test.ts +68 -0
  402. package/skills/maestro-examples/references/chorus/packages/services/src/post/post-db-provider.ts +219 -0
  403. package/skills/maestro-examples/references/chorus/packages/services/src/post/post-use-cases.ts +184 -0
  404. package/skills/maestro-examples/references/chorus/packages/services/src/post/redact-hidden-post.ts +4 -0
  405. package/skills/maestro-examples/references/chorus/packages/services/src/profile/index.ts +17 -0
  406. package/skills/maestro-examples/references/chorus/packages/services/src/profile/profile-db-provider.test.ts +57 -0
  407. package/skills/maestro-examples/references/chorus/packages/services/src/profile/profile-db-provider.ts +75 -0
  408. package/skills/maestro-examples/references/chorus/packages/services/src/profile/profile-use-cases.ts +61 -0
  409. package/skills/maestro-examples/references/chorus/packages/services/src/testing/channel-seed.ts +27 -0
  410. package/skills/maestro-examples/references/chorus/packages/services/src/testing/index.ts +13 -0
  411. package/skills/maestro-examples/references/chorus/packages/services/src/testing/like-seed.ts +21 -0
  412. package/skills/maestro-examples/references/chorus/packages/services/src/testing/post-seed.ts +27 -0
  413. package/skills/maestro-examples/references/chorus/packages/services/src/testing/profile-seed.ts +28 -0
  414. package/skills/maestro-examples/references/chorus/packages/services/src/testing/seed-pipe.ts +38 -0
  415. package/skills/maestro-examples/references/chorus/packages/services/tsconfig.json +9 -0
  416. package/skills/maestro-examples/references/chorus/scripts/foreign-key-delete-behavior.ts +111 -0
  417. package/skills/maestro-examples/references/chorus/specs/app.md +73 -0
  418. package/skills/maestro-examples/references/chorus/specs/data-models.md +48 -0
  419. package/skills/maestro-examples/references/chorus/specs/database-schema.md +59 -0
  420. package/skills/maestro-examples/references/chorus/specs/use-cases.md +33 -0
  421. package/skills/maestro-examples/references/chorus/tsconfig.json +29 -0
  422. package/skills/maestro-examples/references/setlist/IMPLEMENTATION_PLAN.md +88 -0
  423. package/skills/maestro-examples/references/setlist/config/db-migrate.ts +9 -0
  424. package/skills/maestro-examples/references/setlist/config/queue-processor.ts +11 -0
  425. package/skills/maestro-examples/references/setlist/config/services.ts +16 -0
  426. package/skills/maestro-examples/references/setlist/config/setlist-web.ts +12 -0
  427. package/skills/maestro-examples/references/setlist/infrastructure/cdk/index.ts +56 -0
  428. package/skills/maestro-examples/references/setlist/infrastructure/cdk.context.json +5 -0
  429. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/20260316000000_init.ts +16 -0
  430. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/20260317000000_add-queue-and-recurring-job-tables.ts +22 -0
  431. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/sqls/20260316000000_init-down.sql +5 -0
  432. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/sqls/20260316000000_init-up.sql +68 -0
  433. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/sqls/20260317000000_add-queue-and-recurring-job-tables-down.sql +2 -0
  434. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/sqls/20260317000000_add-queue-and-recurring-job-tables-up.sql +21 -0
  435. package/skills/maestro-examples/references/setlist/infrastructure/package.json +20 -0
  436. package/skills/maestro-examples/references/setlist/infrastructure/tsconfig.json +8 -0
  437. package/skills/maestro-examples/references/setlist/package.json +19 -0
  438. package/skills/maestro-examples/references/setlist/packages/email-templates/other/generate-email-modules.ts +22 -0
  439. package/skills/maestro-examples/references/setlist/packages/email-templates/other/generate-email-previews.ts +18 -0
  440. package/skills/maestro-examples/references/setlist/packages/email-templates/package.json +27 -0
  441. package/skills/maestro-examples/references/setlist/packages/email-templates/src/components/button.tsx +19 -0
  442. package/skills/maestro-examples/references/setlist/packages/email-templates/src/components/root-container.tsx +29 -0
  443. package/skills/maestro-examples/references/setlist/packages/email-templates/src/components/tailwind-wrapper.tsx +113 -0
  444. package/skills/maestro-examples/references/setlist/packages/email-templates/src/email-modules.ts +9 -0
  445. package/skills/maestro-examples/references/setlist/packages/email-templates/src/emails/magic-link-login.tsx +49 -0
  446. package/skills/maestro-examples/references/setlist/packages/email-templates/src/index.ts +3 -0
  447. package/skills/maestro-examples/references/setlist/packages/email-templates/src/render-email-template.ts +24 -0
  448. package/skills/maestro-examples/references/setlist/packages/email-templates/src/utils/tw.ts +5 -0
  449. package/skills/maestro-examples/references/setlist/packages/email-templates/tsconfig.json +11 -0
  450. package/skills/maestro-examples/references/setlist/packages/email-templates/tsup.config.ts +10 -0
  451. package/skills/maestro-examples/references/setlist/packages/schemas/package.json +21 -0
  452. package/skills/maestro-examples/references/setlist/packages/schemas/src/area/index.ts +28 -0
  453. package/skills/maestro-examples/references/setlist/packages/schemas/src/index.ts +6 -0
  454. package/skills/maestro-examples/references/setlist/packages/schemas/src/magic-link/index.ts +20 -0
  455. package/skills/maestro-examples/references/setlist/packages/schemas/src/position.ts +137 -0
  456. package/skills/maestro-examples/references/setlist/packages/schemas/src/project/index.ts +44 -0
  457. package/skills/maestro-examples/references/setlist/packages/schemas/src/task/index.ts +41 -0
  458. package/skills/maestro-examples/references/setlist/packages/schemas/src/user/index.ts +28 -0
  459. package/skills/maestro-examples/references/setlist/packages/schemas/tests/position.test.ts +106 -0
  460. package/skills/maestro-examples/references/setlist/packages/schemas/tsconfig.json +9 -0
  461. package/skills/maestro-examples/references/setlist/packages/services/package.json +40 -0
  462. package/skills/maestro-examples/references/setlist/packages/services/run-tests.ts +59 -0
  463. package/skills/maestro-examples/references/setlist/packages/services/src/area/area-db-provider.test.ts +29 -0
  464. package/skills/maestro-examples/references/setlist/packages/services/src/area/area-db-provider.ts +81 -0
  465. package/skills/maestro-examples/references/setlist/packages/services/src/area/area-use-cases.ts +130 -0
  466. package/skills/maestro-examples/references/setlist/packages/services/src/area/index.ts +27 -0
  467. package/skills/maestro-examples/references/setlist/packages/services/src/auth/auth-db-provider.test.ts +34 -0
  468. package/skills/maestro-examples/references/setlist/packages/services/src/auth/auth-db-provider.ts +24 -0
  469. package/skills/maestro-examples/references/setlist/packages/services/src/auth/auth-use-cases.ts +110 -0
  470. package/skills/maestro-examples/references/setlist/packages/services/src/auth/index.ts +18 -0
  471. package/skills/maestro-examples/references/setlist/packages/services/src/auth/magic-link-db-provider.test.ts +52 -0
  472. package/skills/maestro-examples/references/setlist/packages/services/src/auth/magic-link-db-provider.ts +59 -0
  473. package/skills/maestro-examples/references/setlist/packages/services/src/auth/user-db-provider.test.ts +33 -0
  474. package/skills/maestro-examples/references/setlist/packages/services/src/auth/user-db-provider.ts +55 -0
  475. package/skills/maestro-examples/references/setlist/packages/services/src/auth/verify-magic-link-credentials.ts +39 -0
  476. package/skills/maestro-examples/references/setlist/packages/services/src/index.ts +20 -0
  477. package/skills/maestro-examples/references/setlist/packages/services/src/maestro.ts +175 -0
  478. package/skills/maestro-examples/references/setlist/packages/services/src/project/index.ts +29 -0
  479. package/skills/maestro-examples/references/setlist/packages/services/src/project/project-db-provider.test.ts +46 -0
  480. package/skills/maestro-examples/references/setlist/packages/services/src/project/project-db-provider.ts +114 -0
  481. package/skills/maestro-examples/references/setlist/packages/services/src/project/project-use-cases.ts +183 -0
  482. package/skills/maestro-examples/references/setlist/packages/services/src/task/index.ts +39 -0
  483. package/skills/maestro-examples/references/setlist/packages/services/src/task/task-db-provider.test.ts +53 -0
  484. package/skills/maestro-examples/references/setlist/packages/services/src/task/task-db-provider.ts +219 -0
  485. package/skills/maestro-examples/references/setlist/packages/services/src/task/task-use-cases.ts +303 -0
  486. package/skills/maestro-examples/references/setlist/packages/services/src/testing/area-seed.ts +25 -0
  487. package/skills/maestro-examples/references/setlist/packages/services/src/testing/index.ts +13 -0
  488. package/skills/maestro-examples/references/setlist/packages/services/src/testing/project-seed.ts +29 -0
  489. package/skills/maestro-examples/references/setlist/packages/services/src/testing/seed-pipe.ts +38 -0
  490. package/skills/maestro-examples/references/setlist/packages/services/src/testing/task-seed.ts +31 -0
  491. package/skills/maestro-examples/references/setlist/packages/services/src/testing/user-seed.ts +24 -0
  492. package/skills/maestro-examples/references/setlist/packages/services/tsconfig.json +9 -0
  493. package/skills/maestro-examples/references/setlist/queue-processor/package.json +17 -0
  494. package/skills/maestro-examples/references/setlist/queue-processor/src/index.ts +29 -0
  495. package/skills/maestro-examples/references/setlist/queue-processor/src/recurring-jobs.ts +13 -0
  496. package/skills/maestro-examples/references/setlist/queue-processor/tsconfig.json +4 -0
  497. package/skills/maestro-examples/references/setlist/scripts/foreign-key-delete-behavior.ts +107 -0
  498. package/skills/maestro-examples/references/setlist/setlist-web/app/app.css +158 -0
  499. package/skills/maestro-examples/references/setlist/setlist-web/app/components/alert-dialog.tsx +153 -0
  500. package/skills/maestro-examples/references/setlist/setlist-web/app/components/app-dnd-provider.tsx +180 -0
  501. package/skills/maestro-examples/references/setlist/setlist-web/app/components/area-form.tsx +113 -0
  502. package/skills/maestro-examples/references/setlist/setlist-web/app/components/button-group.tsx +78 -0
  503. package/skills/maestro-examples/references/setlist/setlist-web/app/components/button.tsx +139 -0
  504. package/skills/maestro-examples/references/setlist/setlist-web/app/components/checkbox.tsx +210 -0
  505. package/skills/maestro-examples/references/setlist/setlist-web/app/components/context-menu.tsx +78 -0
  506. package/skills/maestro-examples/references/setlist/setlist-web/app/components/date-picker.tsx +214 -0
  507. package/skills/maestro-examples/references/setlist/setlist-web/app/components/dnd-collision-detection.ts +28 -0
  508. package/skills/maestro-examples/references/setlist/setlist-web/app/components/dnd-utils.ts +11 -0
  509. package/skills/maestro-examples/references/setlist/setlist-web/app/components/drag-ghost.tsx +24 -0
  510. package/skills/maestro-examples/references/setlist/setlist-web/app/components/form.tsx +107 -0
  511. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/animated-popover.tsx +27 -0
  512. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/button-context.ts +13 -0
  513. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/calendar-month-year-picker.tsx +283 -0
  514. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/form-field.tsx +231 -0
  515. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/get-button-classes.ts +141 -0
  516. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/headless-button.tsx +39 -0
  517. package/skills/maestro-examples/references/setlist/setlist-web/app/components/icon.tsx +29 -0
  518. package/skills/maestro-examples/references/setlist/setlist-web/app/components/inline-alert.tsx +57 -0
  519. package/skills/maestro-examples/references/setlist/setlist-web/app/components/project-form.tsx +153 -0
  520. package/skills/maestro-examples/references/setlist/setlist-web/app/components/select.tsx +219 -0
  521. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/helpers.ts +73 -0
  522. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/index.ts +6 -0
  523. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/inline-inputs.tsx +128 -0
  524. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/sidebar.tsx +333 -0
  525. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/sortable-rows.tsx +256 -0
  526. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/use-sidebar-dnd.ts +261 -0
  527. package/skills/maestro-examples/references/setlist/setlist-web/app/components/spinner.tsx +19 -0
  528. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-inline-create.tsx +51 -0
  529. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/index.ts +3 -0
  530. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/task-date-helpers.ts +16 -0
  531. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/task-expanded-detail.tsx +273 -0
  532. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/task-keyboard-helpers.ts +5 -0
  533. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/task-list.tsx +134 -0
  534. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/task-row.tsx +100 -0
  535. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/types.ts +49 -0
  536. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/use-expanded-cache.ts +22 -0
  537. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/use-sticky-task.ts +24 -0
  538. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/use-task-reorder.ts +140 -0
  539. package/skills/maestro-examples/references/setlist/setlist-web/app/components/text-area.tsx +151 -0
  540. package/skills/maestro-examples/references/setlist/setlist-web/app/components/text-field.tsx +147 -0
  541. package/skills/maestro-examples/references/setlist/setlist-web/app/components/toast.tsx +179 -0
  542. package/skills/maestro-examples/references/setlist/setlist-web/app/entry.client.tsx +21 -0
  543. package/skills/maestro-examples/references/setlist/setlist-web/app/entry.server.tsx +13 -0
  544. package/skills/maestro-examples/references/setlist/setlist-web/app/features/csrf-middleware.server.ts +17 -0
  545. package/skills/maestro-examples/references/setlist/setlist-web/app/features/custom-error-status-code-middleware.server.ts +31 -0
  546. package/skills/maestro-examples/references/setlist/setlist-web/app/features/rate-limiting-middleware.server.ts +36 -0
  547. package/skills/maestro-examples/references/setlist/setlist-web/app/features/redirect-with-toast.server.ts +14 -0
  548. package/skills/maestro-examples/references/setlist/setlist-web/app/features/request-context.server.ts +52 -0
  549. package/skills/maestro-examples/references/setlist/setlist-web/app/features/security-headers-middleware.server.ts +10 -0
  550. package/skills/maestro-examples/references/setlist/setlist-web/app/hooks/use-area-actions.ts +44 -0
  551. package/skills/maestro-examples/references/setlist/setlist-web/app/hooks/use-csrf-token.ts +6 -0
  552. package/skills/maestro-examples/references/setlist/setlist-web/app/hooks/use-project-actions.ts +80 -0
  553. package/skills/maestro-examples/references/setlist/setlist-web/app/hooks/use-task-actions.ts +65 -0
  554. package/skills/maestro-examples/references/setlist/setlist-web/app/root.tsx +218 -0
  555. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/areas.$id.delete.tsx +19 -0
  556. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/areas.$id.edit.tsx +27 -0
  557. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/areas.$id.reorder.tsx +30 -0
  558. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/areas.tsx +23 -0
  559. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.complete.tsx +19 -0
  560. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.delete.tsx +19 -0
  561. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.edit.tsx +32 -0
  562. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.move.tsx +23 -0
  563. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.reorder.tsx +30 -0
  564. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.uncomplete.tsx +19 -0
  565. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.tsx +23 -0
  566. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.complete.tsx +19 -0
  567. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.delete.tsx +19 -0
  568. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.edit.tsx +27 -0
  569. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.move.tsx +30 -0
  570. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.reorder.tsx +32 -0
  571. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.uncomplete.tsx +19 -0
  572. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.tsx +23 -0
  573. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/areas.$id.tsx +155 -0
  574. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/auth.login.tsx +98 -0
  575. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/auth.logout.tsx +17 -0
  576. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/auth.verify.tsx +154 -0
  577. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/completed.tsx +121 -0
  578. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/inbox.tsx +68 -0
  579. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/projects.$id.tsx +217 -0
  580. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/today.tsx +86 -0
  581. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/upcoming.tsx +83 -0
  582. package/skills/maestro-examples/references/setlist/setlist-web/app/routes.ts +4 -0
  583. package/skills/maestro-examples/references/setlist/setlist-web/app/services.server.ts +1 -0
  584. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/colors.ts +47 -0
  585. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/compose-refs.ts +35 -0
  586. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/tw.ts +16 -0
  587. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-dismiss.ts +27 -0
  588. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-fetcher-complete.ts +17 -0
  589. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-prevent-default.ts +30 -0
  590. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-render-props.ts +42 -0
  591. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-spin-delay.ts +27 -0
  592. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-stable-accessor.ts +14 -0
  593. package/skills/maestro-examples/references/setlist/setlist-web/environment.d.ts +8 -0
  594. package/skills/maestro-examples/references/setlist/setlist-web/instrument.server.mjs +29 -0
  595. package/skills/maestro-examples/references/setlist/setlist-web/knip.json +3 -0
  596. package/skills/maestro-examples/references/setlist/setlist-web/package.json +52 -0
  597. package/skills/maestro-examples/references/setlist/setlist-web/playwright.config.ts +39 -0
  598. package/skills/maestro-examples/references/setlist/setlist-web/react-router.config.ts +12 -0
  599. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-create.test.ts +37 -0
  600. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-delete.test.ts +45 -0
  601. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-deleted-not-in-sidebar.test.ts +44 -0
  602. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-detail-view.test.ts +46 -0
  603. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-edit-title.test.ts +48 -0
  604. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-expand-collapse.test.ts +50 -0
  605. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-list-in-sidebar.test.ts +37 -0
  606. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-reorder-dnd.test.ts +82 -0
  607. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-logout.test.ts +18 -0
  608. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-reject-invalid-token.test.ts +35 -0
  609. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-reject-used-token.test.ts +104 -0
  610. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-request-magic-link.test.ts +29 -0
  611. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-verify-via-pasted-token.test.ts +52 -0
  612. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-verify-via-url.test.ts +48 -0
  613. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth.setup.ts +55 -0
  614. package/skills/maestro-examples/references/setlist/setlist-web/tests/constants.ts +13 -0
  615. package/skills/maestro-examples/references/setlist/setlist-web/tests/dnd-inbox-to-area.test.ts +74 -0
  616. package/skills/maestro-examples/references/setlist/setlist-web/tests/dnd-inbox-to-project.test.ts +73 -0
  617. package/skills/maestro-examples/references/setlist/setlist-web/tests/dnd-move-to-inbox.test.ts +51 -0
  618. package/skills/maestro-examples/references/setlist/setlist-web/tests/dnd-project-to-area.test.ts +76 -0
  619. package/skills/maestro-examples/references/setlist/setlist-web/tests/dnd-project-to-project.test.ts +75 -0
  620. package/skills/maestro-examples/references/setlist/setlist-web/tests/home.test.ts +27 -0
  621. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-complete.test.ts +53 -0
  622. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-completed-not-in-sidebar.test.ts +46 -0
  623. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-create-in-area.test.ts +55 -0
  624. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-create-top-level.test.ts +37 -0
  625. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-delete.test.ts +55 -0
  626. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-edit-notes-date.test.ts +69 -0
  627. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-edit-title.test.ts +48 -0
  628. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-move-into-area.test.ts +72 -0
  629. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-move-out-of-area.test.ts +76 -0
  630. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-reorder-top-level.test.ts +82 -0
  631. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-reorder-within-area.test.ts +91 -0
  632. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-uncomplete.test.ts +39 -0
  633. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-view-tasks.test.ts +48 -0
  634. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-complete-removes-from-active-views.test.ts +52 -0
  635. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-complete.test.ts +46 -0
  636. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-create-in-inbox.test.ts +19 -0
  637. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-create-in-project.test.ts +44 -0
  638. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-delete.test.ts +52 -0
  639. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-edit.test.ts +73 -0
  640. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-reorder-in-project.test.ts +81 -0
  641. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-reorder-inbox.test.ts +80 -0
  642. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-reorder-today.test.ts +103 -0
  643. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-uncomplete.test.ts +51 -0
  644. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-view-details.test.ts +51 -0
  645. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-active-sidebar-highlight.test.ts +38 -0
  646. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-inbox-unassigned-only.test.ts +43 -0
  647. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-navigate-to-completed.test.ts +59 -0
  648. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-navigate-to-inbox.test.ts +21 -0
  649. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-navigate-to-today.test.ts +42 -0
  650. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-navigate-to-upcoming.test.ts +59 -0
  651. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-sidebar-built-in-views.test.ts +23 -0
  652. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-today-shows-overdue.test.ts +48 -0
  653. package/skills/maestro-examples/references/setlist/setlist-web/tsconfig.json +22 -0
  654. package/skills/maestro-examples/references/setlist/setlist-web/vite.config.ts +37 -0
  655. package/skills/maestro-examples/references/setlist/specs/app.md +69 -0
  656. package/skills/maestro-examples/references/setlist/specs/data-models.md +92 -0
  657. package/skills/maestro-examples/references/setlist/specs/database-schema.md +76 -0
  658. package/skills/maestro-examples/references/setlist/specs/drag-and-drop.md +89 -0
  659. package/skills/maestro-examples/references/setlist/specs/magic-link-login.md +300 -0
  660. package/skills/maestro-examples/references/setlist/specs/position-ordering.md +329 -0
  661. package/skills/maestro-examples/references/setlist/specs/sidebar.md +65 -0
  662. package/skills/maestro-examples/references/setlist/specs/use-cases.md +55 -0
  663. package/skills/maestro-examples/references/setlist/tsconfig.json +28 -0
  664. package/{dist → skills}/maestro-packages/SKILL.md +3 -3
  665. package/skills/maestro-packages/permissions.md +215 -0
  666. package/skills/maestro-packages/queue.md +442 -0
  667. package/skills/maestro-packages/recurring-jobs.md +238 -0
  668. package/skills/react-use-effect/SKILL.md +65 -0
  669. package/skills/react-use-effect/references/patterns.md +283 -0
  670. package/dist/maestro-packages/queue.md +0 -284
  671. package/dist/maestro-packages/recurring-jobs.md +0 -353
  672. package/dist/maestro-packages/tracing.md +0 -240
  673. /package/{dist → skills}/maestro-cli/SKILL.md +0 -0
  674. /package/{dist → skills}/maestro-packages/broadcast.md +0 -0
  675. /package/{dist → skills}/maestro-packages/cache-control.md +0 -0
  676. /package/{dist → skills}/maestro-packages/cache.md +0 -0
  677. /package/{dist → skills}/maestro-packages/config.md +0 -0
  678. /package/{dist → skills}/maestro-packages/context.md +0 -0
  679. /package/{dist → skills}/maestro-packages/crypt.md +0 -0
  680. /package/{dist → skills}/maestro-packages/db.md +0 -0
  681. /package/{dist → skills}/maestro-packages/events.md +0 -0
  682. /package/{dist → skills}/maestro-packages/exceptions.md +0 -0
  683. /package/{dist → skills}/maestro-packages/form.md +0 -0
  684. /package/{dist → skills}/maestro-packages/hash.md +0 -0
  685. /package/{dist → skills}/maestro-packages/helpers.md +0 -0
  686. /package/{dist → skills}/maestro-packages/log.md +0 -0
  687. /package/{dist → skills}/maestro-packages/mail.md +0 -0
  688. /package/{dist → skills}/maestro-packages/metrics.md +0 -0
  689. /package/{dist → skills}/maestro-packages/rate-limiting.md +0 -0
  690. /package/{dist → skills}/maestro-packages/react-router-file-routes.md +0 -0
  691. /package/{dist → skills}/maestro-packages/sql.md +0 -0
@@ -0,0 +1,155 @@
1
+ import z from 'zod'
2
+ import { Auth } from '@maestro-js/auth'
3
+ import { Password } from '@maestro-js/password'
4
+ import { Mail } from '@maestro-js/mail'
5
+ import { Log } from '@maestro-js/log'
6
+ import { CustomErrors } from '@maestro-js/custom-errors'
7
+ import { RateLimiting } from '@maestro-js/rate-limiting'
8
+ import { UserSchemas } from '@cadence/schemas'
9
+ import type { Session } from '@maestro-js/session'
10
+ import type { DeviceContext } from '../maestro.ts'
11
+ import { authDbProvider } from './auth-db-provider.ts'
12
+ import { profileDbProvider } from './profile-db-provider.ts'
13
+
14
+ const log = Log.channel('auth')
15
+ const isTesting = process.env.IS_TESTING === 'true'
16
+
17
+ // ─── Errors ────────────────────────────────────────────────────────────────────
18
+
19
+ export const InvalidCredentialsError = CustomErrors.create({
20
+ name: 'InvalidCredentials',
21
+ message: 'Invalid credentials',
22
+ httpStatusCode: 'unauthorized' as const
23
+ })
24
+
25
+ export const TooManyLoginAttemptsError = CustomErrors.create({
26
+ name: 'TooManyLoginAttempts',
27
+ message: 'Too many login attempts. Please try again later.',
28
+ httpStatusCode: 'tooManyRequests' as const
29
+ })
30
+
31
+ // ─── Build Profile ────────────────────────────────────────────────────────────
32
+
33
+ export const GetProfileByUserId = z
34
+ .function({ input: [z.object({ userId: z.number() })] })
35
+ .implement(async ({ userId }) => {
36
+ return profileDbProvider.getByUserId(userId)
37
+ })
38
+
39
+ // ─── Login ─────────────────────────────────────────────────────────────────────
40
+
41
+ const LOGIN_MAX_ATTEMPTS = 10
42
+ const LOGIN_DECAY_SECONDS = 120
43
+
44
+ export const Login = z
45
+ .function({
46
+ input: [
47
+ UserSchemas.loginForm.extend({
48
+ rememberMe: z.boolean().optional(),
49
+ session: z.custom<Session | Promise<Session>>(),
50
+ deviceContext: z.custom<DeviceContext>()
51
+ })
52
+ ]
53
+ })
54
+ .implement(async ({ orgSlug, email: emailRaw, password, rememberMe, session, deviceContext }) => {
55
+ const email = emailRaw.toLowerCase().trim()
56
+ const rateLimitKey = `Auth.login.${orgSlug}.${email}`
57
+
58
+ if (!isTesting) {
59
+ if (await RateLimiting.tooManyAttempts(rateLimitKey, LOGIN_MAX_ATTEMPTS)) {
60
+ throw new TooManyLoginAttemptsError()
61
+ }
62
+ await RateLimiting.increment(rateLimitKey, 1, LOGIN_DECAY_SECONDS)
63
+ }
64
+
65
+ const { id: userId, cookie } = await Auth.login({
66
+ credentials: { orgSlug, email, password },
67
+ rememberMe,
68
+ deviceContext,
69
+ session
70
+ })
71
+
72
+ if (!userId) {
73
+ log.warn('Login failed', { action: 'auth.login', orgSlug, email })
74
+ throw new InvalidCredentialsError()
75
+ }
76
+
77
+ log.info('Login succeeded', { action: 'auth.login', userId })
78
+
79
+ const profile = await profileDbProvider.getByUserId(userId)
80
+
81
+ return { profile, cookie }
82
+ })
83
+
84
+ // ─── Logout ────────────────────────────────────────────────────────────────────
85
+
86
+ export const Logout = z
87
+ .function({
88
+ input: [
89
+ z.object({
90
+ cookieHeader: z.string().nullish(),
91
+ session: z.custom<Session | Promise<Session>>()
92
+ })
93
+ ]
94
+ })
95
+ .implement(async ({ cookieHeader, session }) => {
96
+ const { cookie } = await Auth.logout({ cookieHeader, session })
97
+ log.info('Logout', { action: 'auth.logout' })
98
+ return { cookie }
99
+ })
100
+
101
+ // ─── Request Password Reset ────────────────────────────────────────────────────
102
+
103
+ const REQUEST_RESET_THROTTLE_SECONDS = 60
104
+
105
+ export const RequestPasswordReset = z
106
+ .function({
107
+ input: [z.object({ orgSlug: z.string().min(1), email: z.string().email() })]
108
+ })
109
+ .implement(async ({ orgSlug, email: emailRaw }) => {
110
+ const email = emailRaw.toLowerCase().trim()
111
+
112
+ // Always succeed silently — never reveal whether user/org exists
113
+ const user = await authDbProvider.getAuthenticatableByCredentials({ orgSlug, email })
114
+ if (!user) return
115
+
116
+ // Throttle: one request per 60 seconds per user
117
+ if (!isTesting) {
118
+ const throttleKey = `Auth.passwordReset.${user.id}`
119
+ if (await RateLimiting.tooManyAttempts(throttleKey, 1)) {
120
+ return // silently ignore — do not reveal throttling
121
+ }
122
+ await RateLimiting.increment(throttleKey, 1, REQUEST_RESET_THROTTLE_SECONDS)
123
+ }
124
+
125
+ const token = await Password.createPasswordResetToken(user.id, { expirationMinutes: 60 })
126
+
127
+ await Mail.send({
128
+ to: email,
129
+ subject: 'Reset your Cadence CRM password',
130
+ content: {
131
+ html: `<p>Use this token to reset your password:</p><p><code>${token}</code></p><p>This token expires in 60 minutes.</p>`
132
+ }
133
+ })
134
+
135
+ log.info('Password reset requested', { action: 'auth.requestPasswordReset', userId: user.id })
136
+ })
137
+
138
+ // ─── Reset Password ────────────────────────────────────────────────────────────
139
+
140
+ export const ResetPassword = z
141
+ .function({
142
+ input: [
143
+ z.object({
144
+ token: z.string(),
145
+ newPassword: z.string().min(8)
146
+ })
147
+ ]
148
+ })
149
+ .implement(async ({ token, newPassword }) => {
150
+ await Password.resetPassword({ token, newPassword })
151
+
152
+ // credentialsInvalidBefore is set by Password.resetPassword() internally,
153
+ // which invalidates all existing sessions
154
+ log.info('Password reset completed', { action: 'auth.resetPassword' })
155
+ })
@@ -0,0 +1,17 @@
1
+ import { InvalidCredentialsError, TooManyLoginAttemptsError, Login, Logout, RequestPasswordReset, ResetPassword, GetProfileByUserId } from './auth-use-cases.ts'
2
+ import { Password } from '@maestro-js/password'
3
+
4
+ export const AuthService = {
5
+ Login,
6
+ Logout,
7
+ RequestPasswordReset,
8
+ ResetPassword,
9
+ GetProfileByUserId,
10
+ errors: {
11
+ InvalidCredentialsError,
12
+ TooManyLoginAttemptsError,
13
+ PasswordResetThrottledError: Password.errors.ThrottledError,
14
+ PasswordResetInvalidTokenError: Password.errors.InvalidTokenError,
15
+ PasswordResetExpiredTokenError: Password.errors.ExpiredTokenError
16
+ }
17
+ }
@@ -0,0 +1,17 @@
1
+ import { Db } from '@maestro-js/db'
2
+ import { UserSchemas } from '@cadence/schemas'
3
+
4
+ type Profile = UserSchemas.profileModel
5
+
6
+ async function getByUserId(userId: number): Promise<Profile | null> {
7
+ const rows = await Db.select('SELECT id AS userId, organizationId, role FROM users WHERE id = ? AND deletedDate IS NULL', [
8
+ userId
9
+ ])
10
+ const row = rows[0]
11
+ if (!row) return null
12
+ return UserSchemas.profileModel.parse(row)
13
+ }
14
+
15
+ export const profileDbProvider = {
16
+ getByUserId
17
+ }
@@ -0,0 +1,120 @@
1
+ import { test } from 'beartest-js'
2
+ import { expect } from 'expect'
3
+ import { H } from '../testing/index.ts'
4
+ import { contactDbProvider } from './contact-db-provider.ts'
5
+
6
+ const org = H.OrganizationSeed({ id: 1 })
7
+ const user = H.UserSeed({ id: 1, organizationId: 1 })
8
+ const pipe = H.SeedPipe(org, user)
9
+
10
+ test.beforeEach(async () => { await pipe.setup() })
11
+ test.afterEach(async () => { await pipe.teardown() })
12
+
13
+ const createdIds: number[] = []
14
+ test.afterEach(async () => {
15
+ for (const id of createdIds) {
16
+ await contactDbProvider.hardDelete(id)
17
+ }
18
+ createdIds.length = 0
19
+ })
20
+
21
+ test('create and getById', async () => {
22
+ const id = await contactDbProvider.create({
23
+ organizationId: 1,
24
+ firstName: 'Alice',
25
+ lastName: 'Smith',
26
+ email: 'alice@example.com',
27
+ phone: '555-1234',
28
+ jobTitle: 'Engineer'
29
+ })
30
+ createdIds.push(id)
31
+
32
+ const contact = await contactDbProvider.getById(id)
33
+ expect(contact).not.toBeNull()
34
+ expect(contact!.firstName).toBe('Alice')
35
+ expect(contact!.lastName).toBe('Smith')
36
+ expect(contact!.email).toBe('alice@example.com')
37
+ expect(contact!.phone).toBe('555-1234')
38
+ expect(contact!.jobTitle).toBe('Engineer')
39
+ expect(contact!.tags).toEqual([])
40
+ expect(contact!.archivedDate).toBeNull()
41
+ expect(contact!.deletedDate).toBeNull()
42
+ })
43
+
44
+ test('create with minimal fields', async () => {
45
+ const id = await contactDbProvider.create({ organizationId: 1, firstName: 'Minimal' })
46
+ createdIds.push(id)
47
+
48
+ const contact = await contactDbProvider.getById(id)
49
+ expect(contact).not.toBeNull()
50
+ expect(contact!.firstName).toBe('Minimal')
51
+ expect(contact!.lastName).toBeNull()
52
+ expect(contact!.email).toBeNull()
53
+ expect(contact!.phone).toBeNull()
54
+ expect(contact!.jobTitle).toBeNull()
55
+ })
56
+
57
+ test('update', async () => {
58
+ const id = await contactDbProvider.create({ organizationId: 1, firstName: 'Original' })
59
+ createdIds.push(id)
60
+
61
+ await contactDbProvider.update(id, { firstName: 'Updated', lastName: 'Name', email: 'updated@example.com' })
62
+
63
+ const contact = await contactDbProvider.getById(id)
64
+ expect(contact!.firstName).toBe('Updated')
65
+ expect(contact!.lastName).toBe('Name')
66
+ expect(contact!.email).toBe('updated@example.com')
67
+ })
68
+
69
+ test('updateTags and listDistinctTags', async () => {
70
+ const id1 = await contactDbProvider.create({ organizationId: 1, firstName: 'Tag1' })
71
+ const id2 = await contactDbProvider.create({ organizationId: 1, firstName: 'Tag2' })
72
+ createdIds.push(id1, id2)
73
+
74
+ await contactDbProvider.updateTags(id1, ['vip', 'lead'])
75
+ await contactDbProvider.updateTags(id2, ['lead', 'partner'])
76
+
77
+ const contact = await contactDbProvider.getById(id1)
78
+ expect(contact!.tags).toEqual(['vip', 'lead'])
79
+
80
+ const tags = await contactDbProvider.listDistinctTags(1)
81
+ expect(tags).toEqual(['lead', 'partner', 'vip'])
82
+ })
83
+
84
+ test('listActive and listArchived', async () => {
85
+ const id1 = await contactDbProvider.create({ organizationId: 1, firstName: 'Active' })
86
+ const id2 = await contactDbProvider.create({ organizationId: 1, firstName: 'Archived' })
87
+ createdIds.push(id1, id2)
88
+
89
+ await contactDbProvider.archive(id2)
90
+
91
+ const active = await contactDbProvider.listActive(1)
92
+ const archived = await contactDbProvider.listArchived(1)
93
+
94
+ expect(active.some((c) => c.id === id1)).toBe(true)
95
+ expect(active.some((c) => c.id === id2)).toBe(false)
96
+ expect(archived.some((c) => c.id === id2)).toBe(true)
97
+ })
98
+
99
+ test('archive and restore', async () => {
100
+ const id = await contactDbProvider.create({ organizationId: 1, firstName: 'Archivable' })
101
+ createdIds.push(id)
102
+
103
+ await contactDbProvider.archive(id)
104
+ let contact = await contactDbProvider.getById(id)
105
+ expect(contact!.archivedDate).not.toBeNull()
106
+
107
+ await contactDbProvider.restore(id)
108
+ contact = await contactDbProvider.getById(id)
109
+ expect(contact!.archivedDate).toBeNull()
110
+ })
111
+
112
+ test('softDelete', async () => {
113
+ const id = await contactDbProvider.create({ organizationId: 1, firstName: 'Deletable' })
114
+ createdIds.push(id)
115
+
116
+ await contactDbProvider.softDelete(id)
117
+
118
+ const contact = await contactDbProvider.getById(id)
119
+ expect(contact).toBeNull()
120
+ })
@@ -0,0 +1,145 @@
1
+ import { Db } from '@maestro-js/db'
2
+ import { ContactSchemas } from '@cadence/schemas'
3
+ import { instantFns } from 'iso-fns'
4
+
5
+ type Contact = ContactSchemas.contactModel
6
+ type ContactWithLastContacted = ContactSchemas.contactWithLastContactedModel
7
+
8
+ async function create(
9
+ data: Pick<Contact, 'organizationId' | 'firstName'> & Partial<Pick<Contact, 'lastName' | 'email' | 'phone' | 'jobTitle'>>
10
+ ): Promise<number> {
11
+ const now = instantFns.formatISO9075(instantFns.now())
12
+ const result = await Db.insert(
13
+ 'INSERT INTO contacts (organizationId, firstName, lastName, email, phone, jobTitle, tags, createdDate, lastModifiedDate) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)',
14
+ [
15
+ data.organizationId,
16
+ data.firstName,
17
+ data.lastName ?? null,
18
+ data.email ?? null,
19
+ data.phone ?? null,
20
+ data.jobTitle ?? null,
21
+ JSON.stringify([]),
22
+ now,
23
+ now
24
+ ]
25
+ )
26
+ return result.insertId
27
+ }
28
+
29
+ async function getById(id: number): Promise<Contact | null> {
30
+ const rows = await Db.select('SELECT * FROM contacts WHERE id = ? AND deletedDate IS NULL', [id])
31
+ const row = rows[0]
32
+ if (!row) return null
33
+ return ContactSchemas.contactModel.parse({ ...row, tags: JSON.parse((row.tags as string) ?? '[]') })
34
+ }
35
+
36
+ async function listActive(orgId: number): Promise<ContactWithLastContacted[]> {
37
+ const rows = await Db.select(
38
+ `SELECT c.*, (SELECT MAX(i.date) FROM interactions i WHERE i.contactId = c.id AND i.deletedDate IS NULL) AS lastContactedDate
39
+ FROM contacts c
40
+ WHERE c.organizationId = ? AND c.deletedDate IS NULL AND c.archivedDate IS NULL
41
+ ORDER BY c.firstName ASC, c.lastName ASC`,
42
+ [orgId]
43
+ )
44
+ return rows.map((row) =>
45
+ ContactSchemas.contactWithLastContactedModel.parse({ ...row, tags: JSON.parse((row.tags as string) ?? '[]') })
46
+ )
47
+ }
48
+
49
+ async function listArchived(orgId: number): Promise<ContactWithLastContacted[]> {
50
+ const rows = await Db.select(
51
+ `SELECT c.*, (SELECT MAX(i.date) FROM interactions i WHERE i.contactId = c.id AND i.deletedDate IS NULL) AS lastContactedDate
52
+ FROM contacts c
53
+ WHERE c.organizationId = ? AND c.archivedDate IS NOT NULL AND c.deletedDate IS NULL
54
+ ORDER BY c.firstName ASC, c.lastName ASC`,
55
+ [orgId]
56
+ )
57
+ return rows.map((row) =>
58
+ ContactSchemas.contactWithLastContactedModel.parse({ ...row, tags: JSON.parse((row.tags as string) ?? '[]') })
59
+ )
60
+ }
61
+
62
+ async function update(
63
+ id: number,
64
+ data: Pick<Contact, 'firstName'> & Partial<Pick<Contact, 'lastName' | 'email' | 'phone' | 'jobTitle'>>
65
+ ): Promise<void> {
66
+ const now = instantFns.formatISO9075(instantFns.now())
67
+ await Db.update(
68
+ 'UPDATE contacts SET firstName = ?, lastName = ?, email = ?, phone = ?, jobTitle = ?, lastModifiedDate = ? WHERE id = ?',
69
+ [data.firstName, data.lastName ?? null, data.email ?? null, data.phone ?? null, data.jobTitle ?? null, now, id]
70
+ )
71
+ }
72
+
73
+ async function updateTags(id: number, tags: string[]): Promise<void> {
74
+ const now = instantFns.formatISO9075(instantFns.now())
75
+ await Db.update('UPDATE contacts SET tags = ?, lastModifiedDate = ? WHERE id = ?', [JSON.stringify(tags), now, id])
76
+ }
77
+
78
+ async function archive(id: number): Promise<void> {
79
+ const now = instantFns.formatISO9075(instantFns.now())
80
+ await Db.update('UPDATE contacts SET archivedDate = ?, lastModifiedDate = ? WHERE id = ?', [now, now, id])
81
+ }
82
+
83
+ async function restore(id: number): Promise<void> {
84
+ const now = instantFns.formatISO9075(instantFns.now())
85
+ await Db.update('UPDATE contacts SET archivedDate = NULL, lastModifiedDate = ? WHERE id = ?', [now, id])
86
+ }
87
+
88
+ async function softDelete(id: number): Promise<void> {
89
+ const now = instantFns.formatISO9075(instantFns.now())
90
+ await Db.update('UPDATE contacts SET deletedDate = ?, lastModifiedDate = ? WHERE id = ?', [now, now, id])
91
+ }
92
+
93
+ async function listDistinctTags(orgId: number): Promise<string[]> {
94
+ const rows = await Db.select('SELECT DISTINCT tags FROM contacts WHERE organizationId = ? AND deletedDate IS NULL', [
95
+ orgId
96
+ ])
97
+ const tagSet = new Set<string>()
98
+ for (const row of rows) {
99
+ const parsed: string[] = JSON.parse((row.tags as string) ?? '[]')
100
+ for (const tag of parsed) {
101
+ tagSet.add(tag)
102
+ }
103
+ }
104
+ return [...tagSet].sort()
105
+ }
106
+
107
+ async function seedCreate(data: Contact): Promise<void> {
108
+ const now = instantFns.formatISO9075(instantFns.now())
109
+ await Db.insert(
110
+ 'INSERT INTO contacts (id, organizationId, firstName, lastName, email, phone, jobTitle, tags, archivedDate, deletedDate, createdDate, lastModifiedDate) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)',
111
+ [
112
+ data.id,
113
+ data.organizationId,
114
+ data.firstName,
115
+ data.lastName ?? null,
116
+ data.email ?? null,
117
+ data.phone ?? null,
118
+ data.jobTitle ?? null,
119
+ JSON.stringify(data.tags ?? []),
120
+ data.archivedDate ?? null,
121
+ data.deletedDate ?? null,
122
+ now,
123
+ now
124
+ ]
125
+ )
126
+ }
127
+
128
+ async function hardDelete(id: number): Promise<void> {
129
+ await Db.delete('DELETE FROM contacts WHERE id = ?', [id])
130
+ }
131
+
132
+ export const contactDbProvider = {
133
+ create,
134
+ getById,
135
+ listActive,
136
+ listArchived,
137
+ update,
138
+ updateTags,
139
+ archive,
140
+ restore,
141
+ softDelete,
142
+ listDistinctTags,
143
+ seedCreate,
144
+ hardDelete
145
+ }
@@ -0,0 +1,196 @@
1
+ import z from 'zod'
2
+ import { Log } from '@maestro-js/log'
3
+ import { Permissions } from '@maestro-js/permissions'
4
+ import { CustomErrors } from '@maestro-js/custom-errors'
5
+ import { ContactSchemas, UserSchemas } from '@cadence/schemas'
6
+ import { contactDbProvider } from './contact-db-provider.ts'
7
+ import { interactionDbProvider } from '../interaction/interaction-db-provider.ts'
8
+
9
+ const log = Log.channel('contact')
10
+
11
+ const Profile = UserSchemas.profileModel
12
+
13
+ // ─── Errors ──────────────────────────────────────────────────────────────────
14
+
15
+ export const ContactNotFoundError = CustomErrors.create({
16
+ name: 'ContactNotFoundError',
17
+ message: 'Contact not found',
18
+ httpStatusCode: 'notFound' as const
19
+ })
20
+
21
+ // ─── Create Contact ──────────────────────────────────────────────────────────
22
+
23
+ export const CreateContact = z
24
+ .function({
25
+ input: [ContactSchemas.createContactForm, Profile]
26
+ })
27
+ .implement(async ({ firstName, lastName, email, phone, jobTitle }, profile) => {
28
+ Permissions.gate(profile, 'contact', 'create')
29
+
30
+ const contactId = await contactDbProvider.create({
31
+ organizationId: profile.organizationId,
32
+ firstName,
33
+ lastName,
34
+ email,
35
+ phone,
36
+ jobTitle
37
+ })
38
+
39
+ log.info('Contact created', { action: 'contact.create', userId: profile.userId, contactId })
40
+
41
+ return { contactId }
42
+ })
43
+
44
+ // ─── View Contact ────────────────────────────────────────────────────────────
45
+
46
+ export const ViewContact = z
47
+ .function({
48
+ input: [z.object({ contactId: z.number() }), Profile]
49
+ })
50
+ .implement(async ({ contactId }, profile) => {
51
+ Permissions.gate(profile, 'contact', 'read')
52
+
53
+ const contact = await contactDbProvider.getById(contactId)
54
+ if (!contact || contact.organizationId !== profile.organizationId) {
55
+ throw new ContactNotFoundError()
56
+ }
57
+
58
+ const interactions = await interactionDbProvider.listByContactId(contactId)
59
+
60
+ return { contact, interactions }
61
+ })
62
+
63
+ // ─── Edit Contact ────────────────────────────────────────────────────────────
64
+
65
+ export const EditContact = z
66
+ .function({
67
+ input: [ContactSchemas.editContactForm.extend({ contactId: z.number() }), Profile]
68
+ })
69
+ .implement(async ({ contactId, firstName, lastName, email, phone, jobTitle }, profile) => {
70
+ Permissions.gate(profile, 'contact', 'update')
71
+
72
+ const contact = await contactDbProvider.getById(contactId)
73
+ if (!contact || contact.organizationId !== profile.organizationId) {
74
+ throw new ContactNotFoundError()
75
+ }
76
+
77
+ await contactDbProvider.update(contactId, { firstName, lastName, email, phone, jobTitle })
78
+
79
+ log.info('Contact edited', { action: 'contact.edit', userId: profile.userId, contactId })
80
+ })
81
+
82
+ // ─── Update Tags ─────────────────────────────────────────────────────────────
83
+
84
+ export const UpdateTags = z
85
+ .function({
86
+ input: [ContactSchemas.updateTagsForm.extend({ contactId: z.number() }), Profile]
87
+ })
88
+ .implement(async ({ contactId, tags }, profile) => {
89
+ Permissions.gate(profile, 'contact', 'update')
90
+
91
+ const contact = await contactDbProvider.getById(contactId)
92
+ if (!contact || contact.organizationId !== profile.organizationId) {
93
+ throw new ContactNotFoundError()
94
+ }
95
+
96
+ await contactDbProvider.updateTags(contactId, tags)
97
+
98
+ log.info('Contact tags updated', { action: 'contact.updateTags', userId: profile.userId, contactId })
99
+ })
100
+
101
+ // ─── Archive Contact ─────────────────────────────────────────────────────────
102
+
103
+ export const ArchiveContact = z
104
+ .function({
105
+ input: [z.object({ contactId: z.number() }), Profile]
106
+ })
107
+ .implement(async ({ contactId }, profile) => {
108
+ Permissions.gate(profile, 'contact', 'archive')
109
+
110
+ const contact = await contactDbProvider.getById(contactId)
111
+ if (!contact || contact.organizationId !== profile.organizationId) {
112
+ throw new ContactNotFoundError()
113
+ }
114
+
115
+ await contactDbProvider.archive(contactId)
116
+
117
+ log.info('Contact archived', { action: 'contact.archive', userId: profile.userId, contactId })
118
+ })
119
+
120
+ // ─── Restore Contact ─────────────────────────────────────────────────────────
121
+
122
+ export const RestoreContact = z
123
+ .function({
124
+ input: [z.object({ contactId: z.number() }), Profile]
125
+ })
126
+ .implement(async ({ contactId }, profile) => {
127
+ Permissions.gate(profile, 'contact', 'restore')
128
+
129
+ const contact = await contactDbProvider.getById(contactId)
130
+ if (!contact || contact.organizationId !== profile.organizationId) {
131
+ throw new ContactNotFoundError()
132
+ }
133
+
134
+ await contactDbProvider.restore(contactId)
135
+
136
+ log.info('Contact restored', { action: 'contact.restore', userId: profile.userId, contactId })
137
+ })
138
+
139
+ // ─── Delete Contact ──────────────────────────────────────────────────────────
140
+
141
+ export const DeleteContact = z
142
+ .function({
143
+ input: [z.object({ contactId: z.number() }), Profile]
144
+ })
145
+ .implement(async ({ contactId }, profile) => {
146
+ Permissions.gate(profile, 'contact', 'delete')
147
+
148
+ const contact = await contactDbProvider.getById(contactId)
149
+ if (!contact || contact.organizationId !== profile.organizationId) {
150
+ throw new ContactNotFoundError()
151
+ }
152
+
153
+ await contactDbProvider.softDelete(contactId)
154
+
155
+ log.info('Contact deleted', { action: 'contact.delete', userId: profile.userId, contactId })
156
+ })
157
+
158
+ // ─── List Contacts ───────────────────────────────────────────────────────────
159
+
160
+ export const ListContacts = z
161
+ .function({
162
+ input: [z.object({}), Profile]
163
+ })
164
+ .implement(async (_data, profile) => {
165
+ Permissions.gate(profile, 'contact', 'list')
166
+
167
+ const contacts = await contactDbProvider.listActive(profile.organizationId)
168
+
169
+ return { contacts }
170
+ })
171
+
172
+ // ─── List Archived Contacts ──────────────────────────────────────────────────
173
+
174
+ export const ListArchivedContacts = z
175
+ .function({
176
+ input: [z.object({}), Profile]
177
+ })
178
+ .implement(async (_data, profile) => {
179
+ Permissions.gate(profile, 'contact', 'list')
180
+
181
+ const contacts = await contactDbProvider.listArchived(profile.organizationId)
182
+
183
+ return { contacts }
184
+ })
185
+
186
+ // ─── List Tags ───────────────────────────────────────────────────────────────
187
+
188
+ export const ListTags = z
189
+ .function({
190
+ input: [z.object({}), Profile]
191
+ })
192
+ .implement(async (_data, profile) => {
193
+ const tags = await contactDbProvider.listDistinctTags(profile.organizationId)
194
+
195
+ return { tags }
196
+ })
@@ -0,0 +1,29 @@
1
+ import {
2
+ ContactNotFoundError,
3
+ CreateContact,
4
+ ViewContact,
5
+ EditContact,
6
+ UpdateTags,
7
+ ArchiveContact,
8
+ RestoreContact,
9
+ DeleteContact,
10
+ ListContacts,
11
+ ListArchivedContacts,
12
+ ListTags
13
+ } from './contact-use-cases.ts'
14
+
15
+ export const ContactService = {
16
+ CreateContact,
17
+ ViewContact,
18
+ EditContact,
19
+ UpdateTags,
20
+ ArchiveContact,
21
+ RestoreContact,
22
+ DeleteContact,
23
+ ListContacts,
24
+ ListArchivedContacts,
25
+ ListTags,
26
+ errors: {
27
+ ContactNotFoundError
28
+ }
29
+ }