@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,184 @@
1
+ import z from 'zod'
2
+ import { PostSchemas, ProfileSchemas } from '@chorus/schemas'
3
+ import { Db } from '@maestro-js/db'
4
+ import { CustomErrors } from '@maestro-js/custom-errors'
5
+ import { Permissions } from '@maestro-js/permissions'
6
+ import { FileStorage } from '@maestro-js/file-storage'
7
+ import { Log } from '@maestro-js/log'
8
+ import { channelDbProvider } from '../channel/channel-db-provider.ts'
9
+ import { postDbProvider } from './post-db-provider.ts'
10
+ import { redactHiddenPost } from './redact-hidden-post.ts'
11
+ import { likeDbProvider } from '../like/like-db-provider.ts'
12
+ import { ChannelNotFoundError } from '../channel/channel-use-cases.ts'
13
+
14
+ export const PostNotFoundError = CustomErrors.create({
15
+ name: 'PostNotFound',
16
+ message: 'Post not found'
17
+ })
18
+
19
+ export const CannotReplyToReplyError = CustomErrors.create({
20
+ name: 'CannotReplyToReply',
21
+ message: 'Replies can only be made to top-level posts'
22
+ })
23
+
24
+ export const CreatePost = z
25
+ .function({
26
+ input: [PostSchemas.createPostSchema.extend({ channelId: z.number() }), ProfileSchemas.Profile]
27
+ })
28
+ .implement(async ({ channelId, content, images }, profile) => {
29
+ const channel = await channelDbProvider.getChannelById(channelId)
30
+ if (!channel) throw new ChannelNotFoundError()
31
+
32
+ let postId: number
33
+
34
+ await Db.transaction(async () => {
35
+ postId = await postDbProvider.createPost({ channelId, profileId: profile.profileId, content })
36
+
37
+ if (images && images.length > 0) {
38
+ await postDbProvider.insertImages(postId, images)
39
+ }
40
+ })
41
+
42
+ Log.info({ channel: 'community', action: 'post.created', profileId: profile.profileId, channelId, postId: postId! })
43
+
44
+ return postId!
45
+ })
46
+
47
+ export const CreateReply = z
48
+ .function({
49
+ input: [PostSchemas.createReplySchema.extend({ postId: z.number() }), ProfileSchemas.Profile]
50
+ })
51
+ .implement(async ({ postId, content, images }, profile) => {
52
+ const parentPost = await postDbProvider.getPostById(postId)
53
+ if (!parentPost) throw new PostNotFoundError()
54
+
55
+ let replyId: number
56
+
57
+ await Db.transaction(async () => {
58
+ replyId = await postDbProvider.createPost({
59
+ channelId: parentPost.channelId,
60
+ profileId: profile.profileId,
61
+ content,
62
+ replyingToPostId: postId
63
+ })
64
+
65
+ if (images && images.length > 0) {
66
+ await postDbProvider.insertImages(replyId, images)
67
+ }
68
+ })
69
+
70
+ Log.info({
71
+ channel: 'community',
72
+ action: 'reply.created',
73
+ profileId: profile.profileId,
74
+ channelId: parentPost.channelId,
75
+ postId,
76
+ replyId: replyId!
77
+ })
78
+
79
+ return replyId!
80
+ })
81
+
82
+ export const ViewPost = z
83
+ .function({
84
+ input: [z.object({ postId: z.number() }), ProfileSchemas.Profile.nullable()]
85
+ })
86
+ .implement(async ({ postId }, profile) => {
87
+ function fetchData() {
88
+ const postRaw = postDbProvider.getPostById(postId).then((post) => {
89
+ if (!post) throw new PostNotFoundError()
90
+ return post
91
+ })
92
+
93
+ const repliesRaw = postDbProvider.listRepliesByPostId(postId)
94
+
95
+ const allPostIds = repliesRaw.then((replies) => [postId, ...replies.map((r) => r.id)])
96
+
97
+ const likedByUser = profile
98
+ ? allPostIds.then((allPostIds) => likeDbProvider.batchHasLiked(allPostIds, profile.profileId))
99
+ : new Set<number>()
100
+
101
+ const replies = Promise.all([repliesRaw, likedByUser]).then(([postsRaw, likedByUser]) => {
102
+ return postsRaw.map((post) => ({
103
+ ...post,
104
+ likedByCurrentUser: likedByUser.has(post.id)
105
+ }))
106
+ })
107
+
108
+ const post = Promise.all([postRaw, likedByUser]).then(([postRaw, likedByUser]) => {
109
+ return {
110
+ ...postRaw,
111
+ likedByCurrentUser: likedByUser.has(postRaw.id)
112
+ }
113
+ })
114
+
115
+ return { post, replies }
116
+ }
117
+
118
+ const promises = fetchData()
119
+
120
+ return {
121
+ post: redactHiddenPost(await promises.post),
122
+ replies: await promises.replies
123
+ }
124
+ })
125
+
126
+ export const HidePost = z
127
+ .function({
128
+ input: [z.object({ postId: z.number() }), ProfileSchemas.Profile]
129
+ })
130
+ .implement(async ({ postId }, profile) => {
131
+ const post = await postDbProvider.getPostById(postId)
132
+ if (!post) throw new PostNotFoundError()
133
+
134
+ const isAuthor = post.profileId === profile.profileId
135
+ const channel = await channelDbProvider.getChannelById(post.channelId)
136
+ const isOwner = channel?.ownerProfileId === profile.profileId
137
+
138
+ if (!isAuthor && !channel?.moderatorProfileIds.includes(profile.profileId) && !isOwner) {
139
+ Log.warn({
140
+ channel: 'community',
141
+ action: 'post.hide.denied',
142
+ profileId: profile.profileId,
143
+ postId,
144
+ reason: 'not_authorized'
145
+ })
146
+ throw new Permissions.PermissionsError({ action: 'hide', subject: 'post' })
147
+ }
148
+
149
+ await postDbProvider.hidePost(postId)
150
+
151
+ Log.info({ channel: 'community', action: 'post.hidden', profileId: profile.profileId, postId })
152
+ })
153
+
154
+ const ALLOWED_MIME_TYPES = ['image/jpeg', 'image/png', 'image/gif', 'image/webp']
155
+ const MAX_FILE_SIZE = 5 * 1024 * 1024 // 5MB
156
+
157
+ export const InvalidImageTypeError = CustomErrors.create({
158
+ name: 'InvalidImageType',
159
+ message: 'Only JPEG, PNG, GIF, and WebP images are allowed'
160
+ })
161
+
162
+ export const ImageTooLargeError = CustomErrors.create({
163
+ name: 'ImageTooLarge',
164
+ message: 'Image must be less than 5MB'
165
+ })
166
+
167
+ export const UploadImage = z
168
+ .function({
169
+ input: [z.object({ file: z.custom<File>() }), ProfileSchemas.Profile]
170
+ })
171
+ .implement(async ({ file }, profile) => {
172
+ if (!ALLOWED_MIME_TYPES.includes(file.type)) {
173
+ throw new InvalidImageTypeError()
174
+ }
175
+
176
+ if (file.size > MAX_FILE_SIZE) {
177
+ throw new ImageTooLargeError()
178
+ }
179
+
180
+ const path = await FileStorage.putFile(`post-images`, file)
181
+ const url = FileStorage.url(path)
182
+
183
+ return { url }
184
+ })
@@ -0,0 +1,4 @@
1
+ export function redactHiddenPost<T extends { hiddenDate: unknown; content: string; images: string[] }>(post: T): T {
2
+ if (!post.hiddenDate) return post
3
+ return { ...post, content: '', images: [] }
4
+ }
@@ -0,0 +1,17 @@
1
+ import {
2
+ UpdateProfile,
3
+ UploadProfileImage,
4
+ UsernameTakenError,
5
+ InvalidImageTypeError,
6
+ ImageTooLargeError
7
+ } from './profile-use-cases.ts'
8
+
9
+ export const ProfileService = {
10
+ UpdateProfile,
11
+ UploadProfileImage,
12
+ errors: {
13
+ UsernameTakenError,
14
+ InvalidImageTypeError,
15
+ ImageTooLargeError
16
+ }
17
+ }
@@ -0,0 +1,57 @@
1
+ import { test } from 'beartest-js'
2
+ import { expect } from 'expect'
3
+ import { profileDbProvider } from './profile-db-provider.ts'
4
+
5
+ const createdIds: number[] = []
6
+
7
+ test.afterEach(async () => {
8
+ for (const id of createdIds) {
9
+ await profileDbProvider.hardDelete(id)
10
+ }
11
+ createdIds.length = 0
12
+ })
13
+
14
+ test('createProfile and getProfileById', async () => {
15
+ const id = await profileDbProvider.createProfile({
16
+ email: 'alice@test.com',
17
+ passwordHash: '$2b$10$abcdefghijklmnopqrstuuABCDEFGHIJKLMNOPQRSTUVWXYZ012',
18
+ username: 'alice',
19
+ profileImage: 'https://example.com/alice.png'
20
+ })
21
+ createdIds.push(id)
22
+ const profile = await profileDbProvider.getProfileById(id)
23
+ expect(profile).not.toBeNull()
24
+ expect(profile!.email).toBe('alice@test.com')
25
+ expect(profile!.username).toBe('alice')
26
+ expect(profile!.profileImage).toBe('https://example.com/alice.png')
27
+ })
28
+
29
+ test('updateProfile', async () => {
30
+ const id = await profileDbProvider.createProfile({
31
+ email: 'bob@test.com',
32
+ passwordHash: '$2b$10$abcdefghijklmnopqrstuuABCDEFGHIJKLMNOPQRSTUVWXYZ012',
33
+ username: 'bob',
34
+ profileImage: 'https://example.com/bob.png'
35
+ })
36
+ createdIds.push(id)
37
+ await profileDbProvider.updateProfile(id, { username: 'bob-updated', profileImage: 'https://example.com/bob2.png' })
38
+ const profile = await profileDbProvider.getProfileById(id)
39
+ expect(profile!.username).toBe('bob-updated')
40
+ expect(profile!.profileImage).toBe('https://example.com/bob2.png')
41
+ })
42
+
43
+ test('getProfileByUsername', async () => {
44
+ const id = await profileDbProvider.createProfile({
45
+ email: 'carol@test.com',
46
+ passwordHash: '$2b$10$abcdefghijklmnopqrstuuABCDEFGHIJKLMNOPQRSTUVWXYZ012',
47
+ username: 'carol',
48
+ profileImage: 'https://example.com/carol.png'
49
+ })
50
+ createdIds.push(id)
51
+ const result = await profileDbProvider.getProfileByUsername('carol')
52
+ expect(result).not.toBeNull()
53
+ expect(result!.profileId).toBe(id)
54
+
55
+ const missing = await profileDbProvider.getProfileByUsername('nobody')
56
+ expect(missing).toBeNull()
57
+ })
@@ -0,0 +1,75 @@
1
+ import { Db } from '@maestro-js/db'
2
+ import { ProfileSchemas } from '@chorus/schemas'
3
+ import { instantFns } from 'iso-fns'
4
+ import { z } from 'zod'
5
+
6
+ async function createProfile(data: {
7
+ email: string
8
+ passwordHash: string
9
+ username: string
10
+ profileImage: string
11
+ }): Promise<number> {
12
+ const createdDate = instantFns.now()
13
+ const result = await Db.insert(
14
+ 'INSERT INTO profiles (email, passwordHash, username, profileImage, lastModifiedDate, createdDate) VALUES (?, ?, ?, ?, ?, ?)',
15
+ [
16
+ data.email,
17
+ data.passwordHash,
18
+ data.username,
19
+ data.profileImage,
20
+ instantFns.formatISO9075(createdDate),
21
+ instantFns.formatISO9075(createdDate)
22
+ ]
23
+ )
24
+ return result.insertId
25
+ }
26
+
27
+ async function getProfileById(id: number): Promise<z.infer<typeof ProfileSchemas.Profile> | null> {
28
+ const rows = await Db.select('SELECT profileId, email, username, profileImage FROM profiles WHERE profileId = ?', [id])
29
+ return rows.length ? ProfileSchemas.Profile.parse(rows[0]) : null
30
+ }
31
+
32
+ async function updateProfile(profileId: number, data: { username: string; profileImage?: string | null }): Promise<void> {
33
+ const now = instantFns.formatISO9075(instantFns.now())
34
+
35
+ if (data.profileImage !== undefined) {
36
+ await Db.update('UPDATE profiles SET username = ?, profileImage = ?, lastModifiedDate = ? WHERE profileId = ?', [
37
+ data.username,
38
+ data.profileImage,
39
+ now,
40
+ profileId
41
+ ])
42
+ } else {
43
+ await Db.update('UPDATE profiles SET username = ?, lastModifiedDate = ? WHERE profileId = ?', [
44
+ data.username,
45
+ now,
46
+ profileId
47
+ ])
48
+ }
49
+ }
50
+
51
+ async function getProfileByUsername(username: string): Promise<{ profileId: number } | null> {
52
+ const rows = await Db.select<{ profileId: number }>('SELECT profileId FROM profiles WHERE username = ?', [username])
53
+ return rows[0] ?? null
54
+ }
55
+
56
+ async function seedCreate(data: ProfileSchemas.profileModel & { passwordHash: string }): Promise<void> {
57
+ const now = instantFns.formatISO9075(instantFns.now())
58
+ await Db.insert(
59
+ 'INSERT INTO profiles (profileId, email, passwordHash, username, profileImage, lastModifiedDate, createdDate) VALUES (?, ?, ?, ?, ?, ?, ?)',
60
+ [data.profileId, data.email, data.passwordHash, data.username, data.profileImage, now, now]
61
+ )
62
+ }
63
+
64
+ async function hardDelete(profileId: number): Promise<void> {
65
+ await Db.delete('DELETE FROM profiles WHERE profileId = ?', [profileId])
66
+ }
67
+
68
+ export const profileDbProvider = {
69
+ createProfile,
70
+ getProfileById,
71
+ updateProfile,
72
+ getProfileByUsername,
73
+ seedCreate,
74
+ hardDelete
75
+ }
@@ -0,0 +1,61 @@
1
+ import z from 'zod'
2
+ import { ProfileSchemas } from '@chorus/schemas'
3
+ import { CustomErrors } from '@maestro-js/custom-errors'
4
+ import { FileStorage } from '@maestro-js/file-storage'
5
+ import { Log } from '@maestro-js/log'
6
+ import { profileDbProvider } from './profile-db-provider.ts'
7
+
8
+ export const UsernameTakenError = CustomErrors.create({
9
+ name: 'UsernameTaken',
10
+ message: 'That username is already taken'
11
+ })
12
+
13
+ const ALLOWED_MIME_TYPES = ['image/jpeg', 'image/png', 'image/gif', 'image/webp']
14
+ const MAX_FILE_SIZE = 5 * 1024 * 1024 // 5MB
15
+
16
+ export const InvalidImageTypeError = CustomErrors.create({
17
+ name: 'InvalidProfileImageType',
18
+ message: 'Only JPEG, PNG, GIF, and WebP images are allowed'
19
+ })
20
+
21
+ export const ImageTooLargeError = CustomErrors.create({
22
+ name: 'ProfileImageTooLarge',
23
+ message: 'Image must be less than 5MB'
24
+ })
25
+
26
+ export const UpdateProfile = z
27
+ .function({
28
+ input: [ProfileSchemas.updateProfileSchema, ProfileSchemas.Profile]
29
+ })
30
+ .implement(async ({ username, profileImage }, profile) => {
31
+ const existing = await profileDbProvider.getProfileByUsername(username)
32
+ if (existing && existing.profileId !== profile.profileId) {
33
+ throw new UsernameTakenError()
34
+ }
35
+
36
+ await profileDbProvider.updateProfile(profile.profileId, {
37
+ username,
38
+ ...(profileImage !== undefined ? { profileImage } : {})
39
+ })
40
+
41
+ Log.info({ channel: 'community', action: 'profile.updated', profileId: profile.profileId })
42
+ })
43
+
44
+ export const UploadProfileImage = z
45
+ .function({
46
+ input: [z.object({ file: z.custom<File>() }), ProfileSchemas.Profile]
47
+ })
48
+ .implement(async ({ file }, profile) => {
49
+ if (!ALLOWED_MIME_TYPES.includes(file.type)) {
50
+ throw new InvalidImageTypeError()
51
+ }
52
+
53
+ if (file.size > MAX_FILE_SIZE) {
54
+ throw new ImageTooLargeError()
55
+ }
56
+
57
+ const path = await FileStorage.putFile('profile-images', file)
58
+ const url = FileStorage.url(path)
59
+
60
+ return { url }
61
+ })
@@ -0,0 +1,27 @@
1
+ import type { ChannelSchemas } from '@chorus/schemas'
2
+ import { instantFns } from 'iso-fns'
3
+ import { channelDbProvider } from '../channel/channel-db-provider.ts'
4
+
5
+ export function ChannelSeed(
6
+ channel: Partial<Omit<ChannelSchemas.channelModel, 'moderatorProfileIds'>> & { id: number; ownerProfileId: number }
7
+ ) {
8
+ const mock: Omit<ChannelSchemas.channelModel, 'id' | 'ownerProfileId' | 'moderatorProfileIds'> = {
9
+ name: `Test Channel ${channel.id}`,
10
+ slug: `test-channel-${channel.id}`,
11
+ description: 'A test channel',
12
+ createdDate: instantFns.now(),
13
+ lastModifiedDate: instantFns.now()
14
+ }
15
+ const merged = { ...mock, ...channel }
16
+
17
+ async function setup() {
18
+ await teardown()
19
+ await channelDbProvider.seedCreate(merged)
20
+ }
21
+
22
+ async function teardown() {
23
+ await channelDbProvider.hardDelete(merged.id)
24
+ }
25
+
26
+ return { setup, teardown }
27
+ }
@@ -0,0 +1,13 @@
1
+ import { ChannelSeed } from './channel-seed.ts'
2
+ import { LikeSeed } from './like-seed.ts'
3
+ import { PostSeed } from './post-seed.ts'
4
+ import { ProfileSeed } from './profile-seed.ts'
5
+ import { SeedPipe } from './seed-pipe.ts'
6
+
7
+ export const H = {
8
+ ChannelSeed,
9
+ LikeSeed,
10
+ PostSeed,
11
+ ProfileSeed,
12
+ SeedPipe
13
+ }
@@ -0,0 +1,21 @@
1
+ import type { LikeSchemas } from '@chorus/schemas'
2
+ import { instantFns } from 'iso-fns'
3
+ import { likeDbProvider } from '../like/like-db-provider.ts'
4
+
5
+ export function LikeSeed(like: Partial<LikeSchemas.likeModel> & { postId: number; profileId: number }) {
6
+ const mock: Omit<LikeSchemas.likeModel, 'postId' | 'profileId'> = {
7
+ createdDate: instantFns.now()
8
+ }
9
+ const merged = { ...mock, ...like }
10
+
11
+ async function setup() {
12
+ await teardown()
13
+ await likeDbProvider.seedCreate(merged)
14
+ }
15
+
16
+ async function teardown() {
17
+ await likeDbProvider.hardDelete(merged.postId, merged.profileId)
18
+ }
19
+
20
+ return { setup, teardown }
21
+ }
@@ -0,0 +1,27 @@
1
+ import type { PostSchemas } from '@chorus/schemas'
2
+ import { instantFns } from 'iso-fns'
3
+ import { postDbProvider } from '../post/post-db-provider.ts'
4
+
5
+ export function PostSeed(
6
+ post: Partial<Omit<PostSchemas.postModel, 'images'>> & { id: number; channelId: number; profileId: number }
7
+ ) {
8
+ const mock: Omit<PostSchemas.postModel, 'id' | 'channelId' | 'profileId' | 'images'> = {
9
+ content: 'Test post content',
10
+ replyingToPostId: null,
11
+ hiddenDate: null,
12
+ createdDate: instantFns.now(),
13
+ lastModifiedDate: instantFns.now()
14
+ }
15
+ const merged = { ...mock, ...post }
16
+
17
+ async function setup() {
18
+ await teardown()
19
+ await postDbProvider.seedCreate(merged)
20
+ }
21
+
22
+ async function teardown() {
23
+ await postDbProvider.hardDelete(merged.id)
24
+ }
25
+
26
+ return { setup, teardown }
27
+ }
@@ -0,0 +1,28 @@
1
+ import type { ProfileSchemas } from '@chorus/schemas'
2
+ import { instantFns } from 'iso-fns'
3
+ import { profileDbProvider } from '../profile/profile-db-provider.ts'
4
+
5
+ export function ProfileSeed(
6
+ profile: Partial<ProfileSchemas.profileModel & { passwordHash: string }> & { profileId: number }
7
+ ) {
8
+ const mock: Omit<ProfileSchemas.profileModel, 'profileId'> & { passwordHash: string } = {
9
+ email: `test-${profile.profileId}@example.com`,
10
+ passwordHash: '$2b$10$abcdefghijklmnopqrstuuABCDEFGHIJKLMNOPQRSTUVWXYZ012',
11
+ username: `test-user-${profile.profileId}`,
12
+ profileImage: 'https://example.com/default.png',
13
+ createdDate: instantFns.formatISO9075(instantFns.now()),
14
+ lastModifiedDate: instantFns.formatISO9075(instantFns.now())
15
+ }
16
+ const merged = { ...mock, ...profile }
17
+
18
+ async function setup() {
19
+ await teardown()
20
+ await profileDbProvider.seedCreate(merged)
21
+ }
22
+
23
+ async function teardown() {
24
+ await profileDbProvider.hardDelete(merged.profileId)
25
+ }
26
+
27
+ return { setup, teardown }
28
+ }
@@ -0,0 +1,38 @@
1
+ export type SeedFn = { setup(): Promise<void>; teardown: () => Promise<void> }
2
+
3
+ export function SeedPipe(...seeds: SeedFn[]): SeedFn {
4
+ const seedFnMap = new Map<() => Promise<SeedFn>, Promise<SeedFn>>()
5
+
6
+ function resolveSeeder(seeder: SeedFn | (() => Promise<SeedFn>)): Promise<SeedFn> {
7
+ if (typeof seeder === 'function') {
8
+ const existing = seedFnMap.get(seeder)
9
+ if (existing) {
10
+ return existing
11
+ } else {
12
+ seedFnMap.set(seeder, seeder())
13
+ return seedFnMap.get(seeder)!
14
+ }
15
+ } else {
16
+ return Promise.resolve(seeder)
17
+ }
18
+ }
19
+
20
+ async function setup() {
21
+ for (const seed of seeds) {
22
+ const seeder = await resolveSeeder(seed)
23
+ await seeder.setup()
24
+ }
25
+ }
26
+
27
+ async function teardown() {
28
+ const seedsReversed = [...seeds].reverse()
29
+ for (const seed of seedsReversed) {
30
+ const seeder = await resolveSeeder(seed)
31
+ await seeder.teardown()
32
+ }
33
+ }
34
+ return {
35
+ setup,
36
+ teardown
37
+ }
38
+ }
@@ -0,0 +1,9 @@
1
+ {
2
+ "extends": "../../tsconfig.json",
3
+ "compilerOptions": {
4
+ "module": "es2022",
5
+ "moduleResolution": "bundler",
6
+ "allowImportingTsExtensions": true
7
+ },
8
+ "include": ["./src", "./environment.d.ts"]
9
+ }
@@ -0,0 +1,111 @@
1
+ import { Db } from '@maestro-js/db'
2
+
3
+ Db.Provider.register(
4
+ 'default',
5
+ Db.Provider.create({
6
+ driver: Db.drivers.mysql({
7
+ user: process.env.DB_USER!,
8
+ password: process.env.DB_PASSWORD!,
9
+ host: process.env.DB_HOSTNAME!,
10
+ database: process.env.DB_DATABASE!,
11
+ port: Number(process.env.DB_PORT!)
12
+ })
13
+ })
14
+ )
15
+
16
+ const FKS = {
17
+ fk_channelModerators_channelId: 'CASCADE',
18
+ fk_channelModerators_profileId: 'CASCADE',
19
+ fk_channels_ownerProfileId: 'CASCADE',
20
+ fk_likes_postId: 'CASCADE',
21
+ fk_likes_profileId: 'CASCADE',
22
+ fk_password_reset_tokens_profile_id: 'CASCADE',
23
+ fk_postImages_postId: 'CASCADE',
24
+ fk_posts_channelId: 'CASCADE',
25
+ fk_posts_profileId: 'CASCADE',
26
+ fk_posts_replyingToPostId: 'CASCADE',
27
+ fk_remember_me_tokens_profile_id: 'CASCADE'
28
+ }
29
+
30
+ type ForeignKey = {
31
+ TABLE_NAME: string
32
+ COLUMN_NAME: string
33
+ REFERENCED_TABLE_NAME: string
34
+ REFERENCED_COLUMN_NAME: string
35
+ CONSTRAINT_NAME: string
36
+ }
37
+
38
+ const foreignKeys = await Db.select<ForeignKey>(
39
+ `SELECT
40
+ TABLE_NAME,
41
+ COLUMN_NAME,
42
+ REFERENCED_TABLE_NAME,
43
+ REFERENCED_COLUMN_NAME,
44
+ CONSTRAINT_NAME
45
+ FROM information_schema.KEY_COLUMN_USAGE
46
+ WHERE TABLE_SCHEMA = ?
47
+ AND REFERENCED_TABLE_NAME IS NOT NULL
48
+ ORDER BY TABLE_NAME, COLUMN_NAME`,
49
+ [process.env.DB_DATABASE!]
50
+ )
51
+
52
+ const dbFkNames = new Set(foreignKeys.map((fk) => fk.CONSTRAINT_NAME))
53
+ const localFkNames = new Set(Object.keys(FKS))
54
+
55
+ const missingFromLocal = [...dbFkNames].filter((name) => !localFkNames.has(name))
56
+ const extraInLocal = [...localFkNames].filter((name) => !dbFkNames.has(name))
57
+
58
+ if (missingFromLocal.length > 0) {
59
+ console.error('Foreign keys in database but missing from FKS:', missingFromLocal)
60
+ }
61
+ if (extraInLocal.length > 0) {
62
+ console.error('Foreign keys in FKS but not in database:', extraInLocal)
63
+ }
64
+ if (missingFromLocal.length > 0 || extraInLocal.length > 0) {
65
+ process.exit(1)
66
+ }
67
+
68
+ console.log('FKS matches database foreign keys')
69
+
70
+ async function applyOnDeleteRestrict() {
71
+ for (const constraintName of Object.keys(FKS)) {
72
+ const fk = foreignKeys.find((f) => f.CONSTRAINT_NAME === constraintName)!
73
+ await Db.statement(`ALTER TABLE ${fk.TABLE_NAME} DROP FOREIGN KEY ${constraintName}`)
74
+ await Db.statement(
75
+ `ALTER TABLE ${fk.TABLE_NAME}
76
+ ADD CONSTRAINT ${constraintName}
77
+ FOREIGN KEY (${fk.COLUMN_NAME})
78
+ REFERENCES ${fk.REFERENCED_TABLE_NAME}(${fk.REFERENCED_COLUMN_NAME})
79
+ ON DELETE RESTRICT`
80
+ )
81
+ console.log(`${constraintName}: ON DELETE RESTRICT applied`)
82
+ }
83
+ }
84
+
85
+ async function applyOnDeleteCascade() {
86
+ for (const [constraintName, behavior] of Object.entries(FKS)) {
87
+ const fk = foreignKeys.find((f) => f.CONSTRAINT_NAME === constraintName)!
88
+ await Db.statement(`ALTER TABLE ${fk.TABLE_NAME} DROP FOREIGN KEY ${constraintName}`)
89
+ await Db.statement(
90
+ `ALTER TABLE ${fk.TABLE_NAME}
91
+ ADD CONSTRAINT ${constraintName}
92
+ FOREIGN KEY (${fk.COLUMN_NAME})
93
+ REFERENCES ${fk.REFERENCED_TABLE_NAME}(${fk.REFERENCED_COLUMN_NAME})
94
+ ON DELETE ${behavior}`
95
+ )
96
+ console.log(`${constraintName}: ON DELETE ${behavior} applied`)
97
+ }
98
+ }
99
+
100
+ const action = process.argv[2]
101
+
102
+ if (action === 'cascade') {
103
+ await applyOnDeleteCascade()
104
+ } else if (action === 'restrict') {
105
+ await applyOnDeleteRestrict()
106
+ } else {
107
+ console.error('Usage: foreign-key-delete-behavior <cascade|restrict>')
108
+ process.exit(1)
109
+ }
110
+
111
+ process.exit(0)