@stackonward/cli 0.0.1 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (638) hide show
  1. package/dist/index.js +4588 -205
  2. package/dist/index.js.map +1 -1
  3. package/dist/resources/apple/.claude/docs/architecture-template.md +54 -0
  4. package/dist/resources/apple/.claude/docs/architecture.md +52 -0
  5. package/dist/resources/apple/.claude/docs/index.md +13 -0
  6. package/dist/resources/apple/.claude/docs/security-lifecycle.md +57 -0
  7. package/dist/resources/apple/.claude/docs/stack.md +93 -0
  8. package/dist/resources/apple/.claude/docs/verification.md +63 -0
  9. package/dist/resources/apple/AGENTS.md +397 -0
  10. package/dist/resources/apple/CLAUDE.md +397 -0
  11. package/dist/resources/apple/Gemfile +2 -0
  12. package/dist/resources/apple/Gemfile.lock +365 -0
  13. package/dist/resources/apple/_gitignore +14 -0
  14. package/dist/resources/apple/fastlane/Fastfile +123 -0
  15. package/dist/resources/components/nuxt/site-source/app/app.vue +42 -0
  16. package/dist/resources/components/nuxt/site-source/app/assets/css/site-shell.css +1035 -0
  17. package/dist/resources/components/nuxt/site-source/app/assets/icons/brand/.gitkeep +0 -0
  18. package/dist/resources/components/nuxt/site-source/app/assets/icons/common/.gitkeep +0 -0
  19. package/dist/resources/components/nuxt/site-source/app/components/site/ApplicationHeader.vue +35 -0
  20. package/dist/resources/components/nuxt/site-source/app/components/site/ApplicationShell.vue +56 -0
  21. package/dist/resources/components/nuxt/site-source/app/components/site/ApplicationSidebar.vue +40 -0
  22. package/dist/resources/components/nuxt/site-source/app/components/site/BackToTop.vue +42 -0
  23. package/dist/resources/components/nuxt/site-source/app/components/site/ContentArticlePage.vue +40 -0
  24. package/dist/resources/components/nuxt/site-source/app/components/site/ContentListPage.vue +30 -0
  25. package/dist/resources/components/nuxt/site-source/app/components/site/CookieConsent.vue +18 -0
  26. package/dist/resources/components/nuxt/site-source/app/components/site/MarketingFooter.vue +52 -0
  27. package/dist/resources/components/nuxt/site-source/app/components/site/MarketingHeader.vue +106 -0
  28. package/dist/resources/components/nuxt/site-source/app/components/site/MarketingShell.vue +35 -0
  29. package/dist/resources/components/nuxt/site-source/app/components/site/SiteBrand.vue +10 -0
  30. package/dist/resources/components/nuxt/site-source/app/components/site/StaticPage.vue +21 -0
  31. package/dist/resources/components/nuxt/site-source/app/components/site/ToastViewport.vue +25 -0
  32. package/dist/resources/components/nuxt/site-source/app/components/ui/BaseButton.vue +86 -0
  33. package/dist/resources/components/nuxt/site-source/app/components/ui/BaseGradientBorder.vue +59 -0
  34. package/dist/resources/components/nuxt/site-source/app/components/ui/BaseModal.vue +131 -0
  35. package/dist/resources/components/nuxt/site-source/app/components/ui/BasePopover.vue +150 -0
  36. package/dist/resources/components/nuxt/site-source/app/components/ui/BaseText.vue +138 -0
  37. package/dist/resources/components/nuxt/site-source/app/components/ui/CheckoutStatus.vue +112 -0
  38. package/dist/resources/components/nuxt/site-source/app/components/ui/CheckoutSummary.vue +172 -0
  39. package/dist/resources/components/nuxt/site-source/app/components/ui/GoogleSignInButton.vue +113 -0
  40. package/dist/resources/components/nuxt/site-source/app/components/ui/InfiniteScroll.vue +123 -0
  41. package/dist/resources/components/nuxt/site-source/app/components/ui/YoutubeEmbed.vue +126 -0
  42. package/dist/resources/components/nuxt/site-source/app/composables/useAnalytics.ts +24 -0
  43. package/dist/resources/components/nuxt/site-source/app/composables/useCheckout.ts +121 -0
  44. package/dist/resources/components/nuxt/site-source/app/composables/useConsent.ts +31 -0
  45. package/dist/resources/components/nuxt/site-source/app/composables/useGoogleIdentity.ts +163 -0
  46. package/dist/resources/components/nuxt/site-source/app/composables/useNavigation.ts +11 -0
  47. package/dist/resources/components/nuxt/site-source/app/composables/useSeo.ts +33 -0
  48. package/dist/resources/components/nuxt/site-source/app/composables/useSiteShell.ts +58 -0
  49. package/dist/resources/components/nuxt/site-source/app/composables/useToasts.ts +48 -0
  50. package/dist/resources/components/nuxt/site-source/app/layouts/app.vue +5 -0
  51. package/dist/resources/components/nuxt/site-source/app/layouts/default.vue +5 -0
  52. package/dist/resources/components/nuxt/site-source/app/plugins/analytics.client.ts +121 -0
  53. package/dist/resources/components/nuxt/site-source/app/plugins/google-identity.client.ts +24 -0
  54. package/dist/resources/components/nuxt/site-source/app/theme/accordion.ts +9 -0
  55. package/dist/resources/components/nuxt/site-source/app/theme/breadcrumb.ts +8 -0
  56. package/dist/resources/components/nuxt/site-source/app/theme/button.ts +92 -0
  57. package/dist/resources/components/nuxt/site-source/app/theme/carousel.ts +11 -0
  58. package/dist/resources/components/nuxt/site-source/app/theme/checkbox.ts +12 -0
  59. package/dist/resources/components/nuxt/site-source/app/theme/index.ts +30 -0
  60. package/dist/resources/components/nuxt/site-source/app/theme/input.ts +47 -0
  61. package/dist/resources/components/nuxt/site-source/app/theme/modal.ts +9 -0
  62. package/dist/resources/components/nuxt/site-source/app/theme/pagination.ts +6 -0
  63. package/dist/resources/components/nuxt/site-source/app/theme/select.ts +23 -0
  64. package/dist/resources/components/nuxt/site-source/app/theme/stepper.ts +10 -0
  65. package/dist/resources/components/nuxt/site-source/app/theme/toast.ts +8 -0
  66. package/dist/resources/components/nuxt/site-source/app/theme/tooltip.ts +6 -0
  67. package/dist/resources/components/nuxt/site-source/app/types/site-shell.ts +85 -0
  68. package/dist/resources/components/react/ui/Button.tsx +73 -0
  69. package/dist/resources/components/react/ui/Input.tsx +44 -0
  70. package/dist/resources/components/registry.json +355 -0
  71. package/dist/resources/components/vue/feedback/Toast.vue +120 -0
  72. package/dist/resources/components/vue/feedback/useToast.ts +70 -0
  73. package/dist/resources/components/vue/media/FileUpload.vue +229 -0
  74. package/dist/resources/components/vue/media/VideoPlayer.vue +157 -0
  75. package/dist/resources/components/vue/ui/AppImage.vue +147 -0
  76. package/dist/resources/components/vue/ui/BottomSheet.vue +217 -0
  77. package/dist/resources/components/vue/ui/Button.vue +154 -0
  78. package/dist/resources/components/vue/ui/Card.vue +111 -0
  79. package/dist/resources/components/vue/ui/Input.vue +113 -0
  80. package/dist/resources/components/vue/ui/Modal.vue +193 -0
  81. package/dist/resources/components/vue/ui/ScrollArea.vue +163 -0
  82. package/dist/resources/components/vue/ui/Tooltip.vue +115 -0
  83. package/dist/resources/registry.json +158 -0
  84. package/dist/resources/snippets/node/cache.ts +116 -0
  85. package/dist/resources/snippets/node/date.ts +126 -0
  86. package/dist/resources/snippets/node/logger.ts +104 -0
  87. package/dist/resources/snippets/node/validation.ts +132 -0
  88. package/dist/resources/snippets/react/useDebounce.ts +90 -0
  89. package/dist/resources/snippets/registry.json +65 -0
  90. package/dist/resources/snippets/vue/useAsync.ts +96 -0
  91. package/dist/resources/snippets/vue/usePagination.ts +102 -0
  92. package/dist/resources/templates/base/.claude/docs/architecture-template.md +459 -0
  93. package/dist/resources/templates/base/.claude/docs/architecture.md +137 -0
  94. package/dist/resources/templates/base/.claude/docs/index.md +42 -0
  95. package/dist/resources/templates/base/.claude/docs/security-lifecycle.md +129 -0
  96. package/dist/resources/templates/base/.claude/docs/verification.md +121 -0
  97. package/dist/resources/templates/base/AGENTS.md +415 -0
  98. package/dist/resources/templates/base/CLAUDE.md +415 -0
  99. package/dist/resources/templates/go-backend/.claude/docs/api-design.md +486 -0
  100. package/dist/resources/templates/go-backend/.claude/docs/architecture-template.md +449 -0
  101. package/dist/resources/templates/go-backend/.claude/docs/check-list.md +155 -0
  102. package/dist/resources/templates/go-backend/.claude/docs/database.md +369 -0
  103. package/dist/resources/templates/go-backend/.claude/docs/e2e-standards.md +161 -0
  104. package/dist/resources/templates/go-backend/.claude/docs/error-handling.md +558 -0
  105. package/dist/resources/templates/go-backend/.claude/docs/event-runtime-boundary.md +124 -0
  106. package/dist/resources/templates/go-backend/.claude/docs/identifier-contract.md +195 -0
  107. package/dist/resources/templates/go-backend/.claude/docs/index.md +22 -0
  108. package/dist/resources/templates/go-backend/.claude/docs/logging.md +314 -0
  109. package/dist/resources/templates/go-backend/.claude/docs/mediagen-provider-onboarding-sop.md +917 -0
  110. package/dist/resources/templates/go-backend/.claude/docs/mediagen-provider-quick-reference.md +195 -0
  111. package/dist/resources/templates/go-backend/.claude/docs/module-standards.md +309 -0
  112. package/dist/resources/templates/go-backend/.claude/docs/openapi-contract.md +141 -0
  113. package/dist/resources/templates/go-backend/.claude/docs/payment-gateway-onboarding.md +283 -0
  114. package/dist/resources/templates/go-backend/.claude/docs/platform-boundary.md +191 -0
  115. package/dist/resources/templates/go-backend/.claude/docs/quality-gates.md +112 -0
  116. package/dist/resources/templates/go-backend/.dockerignore +6 -0
  117. package/dist/resources/templates/go-backend/.env.example +13 -0
  118. package/dist/resources/templates/go-backend/.gitattributes +2 -0
  119. package/dist/resources/templates/go-backend/AGENTS.md +1139 -0
  120. package/dist/resources/templates/go-backend/CLAUDE.md +1139 -0
  121. package/dist/resources/templates/go-backend/Dockerfile +14 -0
  122. package/dist/resources/templates/go-backend/Makefile +71 -0
  123. package/dist/resources/templates/go-backend/README.md +66 -0
  124. package/dist/resources/templates/go-backend/_gitignore +10 -0
  125. package/dist/resources/templates/go-backend/api/openapi/README.md +29 -0
  126. package/dist/resources/templates/go-backend/api/openapi/dist/artifact-manifest.json +19 -0
  127. package/dist/resources/templates/go-backend/api/openapi/dist/conformance-matrix.json +276 -0
  128. package/dist/resources/templates/go-backend/api/openapi/document.go +30 -0
  129. package/dist/resources/templates/go-backend/api/openapi/package.json +28 -0
  130. package/dist/resources/templates/go-backend/api/openapi/pnpm-lock.yaml +3052 -0
  131. package/dist/resources/templates/go-backend/api/openapi/redocly-source.yaml +18 -0
  132. package/dist/resources/templates/go-backend/api/openapi/redocly.yaml +8 -0
  133. package/dist/resources/templates/go-backend/api/openapi/sdk-generators.json +16 -0
  134. package/dist/resources/templates/go-backend/api/openapi/service-registry.json +39 -0
  135. package/dist/resources/templates/go-backend/api/openapi/services/product-api/conformance/runtime.arazzo.yaml +65 -0
  136. package/dist/resources/templates/go-backend/api/openapi/services/product-api/dist/internal.openapi.json +327 -0
  137. package/dist/resources/templates/go-backend/api/openapi/services/product-api/dist/runtime-contract.json +56 -0
  138. package/dist/resources/templates/go-backend/api/openapi/services/product-api/openapi.yaml +222 -0
  139. package/dist/resources/templates/go-backend/api/openapi/services/worker/conformance/runtime.arazzo.yaml +65 -0
  140. package/dist/resources/templates/go-backend/api/openapi/services/worker/dist/internal.openapi.json +327 -0
  141. package/dist/resources/templates/go-backend/api/openapi/services/worker/dist/runtime-contract.json +56 -0
  142. package/dist/resources/templates/go-backend/api/openapi/services/worker/openapi.yaml +222 -0
  143. package/dist/resources/templates/go-backend/api/openapi/tooling/breaking.mjs +416 -0
  144. package/dist/resources/templates/go-backend/api/openapi/tooling/build.mjs +103 -0
  145. package/dist/resources/templates/go-backend/api/openapi/tooling/conformance_coverage.mjs +111 -0
  146. package/dist/resources/templates/go-backend/api/openapi/tooling/contract_compiler.mjs +62 -0
  147. package/dist/resources/templates/go-backend/api/openapi/tooling/contract_policy.mjs +208 -0
  148. package/dist/resources/templates/go-backend/api/openapi/tooling/delegated_contract.mjs +302 -0
  149. package/dist/resources/templates/go-backend/api/openapi/tooling/deterministic_archive.mjs +69 -0
  150. package/dist/resources/templates/go-backend/api/openapi/tooling/documentation_example_privacy.mjs +93 -0
  151. package/dist/resources/templates/go-backend/api/openapi/tooling/documentation_projection.mjs +498 -0
  152. package/dist/resources/templates/go-backend/api/openapi/tooling/documentation_quality.mjs +346 -0
  153. package/dist/resources/templates/go-backend/api/openapi/tooling/git_artifact_history.mjs +188 -0
  154. package/dist/resources/templates/go-backend/api/openapi/tooling/manifest.mjs +170 -0
  155. package/dist/resources/templates/go-backend/api/openapi/tooling/overlay.mjs +98 -0
  156. package/dist/resources/templates/go-backend/api/openapi/tooling/project.mjs +549 -0
  157. package/dist/resources/templates/go-backend/api/openapi/tooling/route_contract.mjs +156 -0
  158. package/dist/resources/templates/go-backend/api/openapi/tooling/runtime_conformance.mjs +193 -0
  159. package/dist/resources/templates/go-backend/api/openapi/tooling/scalar_asset_localization.mjs +164 -0
  160. package/dist/resources/templates/go-backend/api/openapi/tooling/sdk_generator.mjs +229 -0
  161. package/dist/resources/templates/go-backend/api/openapi/tooling/semantic_version.mjs +64 -0
  162. package/dist/resources/templates/go-backend/api/openapi/tooling/service_contract_inputs.mjs +16 -0
  163. package/dist/resources/templates/go-backend/api/openapi/tooling/test/breaking.test.mjs +365 -0
  164. package/dist/resources/templates/go-backend/api/openapi/tooling/test/build.test.mjs +42 -0
  165. package/dist/resources/templates/go-backend/api/openapi/tooling/test/conformance_coverage.test.mjs +88 -0
  166. package/dist/resources/templates/go-backend/api/openapi/tooling/test/contract_policy.test.mjs +257 -0
  167. package/dist/resources/templates/go-backend/api/openapi/tooling/test/delegated_contract.test.mjs +205 -0
  168. package/dist/resources/templates/go-backend/api/openapi/tooling/test/documentation_example_privacy.test.mjs +51 -0
  169. package/dist/resources/templates/go-backend/api/openapi/tooling/test/documentation_projection.test.mjs +368 -0
  170. package/dist/resources/templates/go-backend/api/openapi/tooling/test/documentation_quality.test.mjs +151 -0
  171. package/dist/resources/templates/go-backend/api/openapi/tooling/test/git_artifact_history.test.mjs +60 -0
  172. package/dist/resources/templates/go-backend/api/openapi/tooling/test/head_policy.test.mjs +8 -0
  173. package/dist/resources/templates/go-backend/api/openapi/tooling/test/overlay.test.mjs +44 -0
  174. package/dist/resources/templates/go-backend/api/openapi/tooling/test/projection.test.mjs +270 -0
  175. package/dist/resources/templates/go-backend/api/openapi/tooling/test/redocly_documentation_rules.test.mjs +146 -0
  176. package/dist/resources/templates/go-backend/api/openapi/tooling/test/release_manifest.test.mjs +76 -0
  177. package/dist/resources/templates/go-backend/api/openapi/tooling/test/route_contract.test.mjs +119 -0
  178. package/dist/resources/templates/go-backend/api/openapi/tooling/test/runtime_conformance.test.mjs +75 -0
  179. package/dist/resources/templates/go-backend/api/openapi/tooling/test/scalar_asset_localization.test.mjs +50 -0
  180. package/dist/resources/templates/go-backend/api/openapi/tooling/test/sdk_generator.test.mjs +31 -0
  181. package/dist/resources/templates/go-backend/api/openapi/tooling/test/semantic_version.test.mjs +60 -0
  182. package/dist/resources/templates/go-backend/api/openapi/tooling/test/service_contract_inputs.test.mjs +27 -0
  183. package/dist/resources/templates/go-backend/cmd/internal/runtime/resources.go +125 -0
  184. package/dist/resources/templates/go-backend/cmd/internal/runtime/runtime.go +102 -0
  185. package/dist/resources/templates/go-backend/cmd/internal/runtime/runtime_test.go +70 -0
  186. package/dist/resources/templates/go-backend/cmd/product-api/lifecycle_test.go +58 -0
  187. package/dist/resources/templates/go-backend/cmd/product-api/main.go +32 -0
  188. package/dist/resources/templates/go-backend/cmd/product-api/wire.go +13 -0
  189. package/dist/resources/templates/go-backend/cmd/product-api/wire_gen.go +94 -0
  190. package/dist/resources/templates/go-backend/cmd/worker/main.go +47 -0
  191. package/dist/resources/templates/go-backend/cmd/worker/wire.go +14 -0
  192. package/dist/resources/templates/go-backend/cmd/worker/wire_gen.go +111 -0
  193. package/dist/resources/templates/go-backend/configs/config.yaml +37 -0
  194. package/dist/resources/templates/go-backend/deployments/compose.yaml +71 -0
  195. package/dist/resources/templates/go-backend/docs/openapi-provenance.json +489 -0
  196. package/dist/resources/templates/go-backend/docs/runtime-provenance.json +175 -0
  197. package/dist/resources/templates/go-backend/docs/source-provenance.json +3568 -0
  198. package/dist/resources/templates/go-backend/docs/standards-provenance.json +1624 -0
  199. package/dist/resources/templates/go-backend/go.mod +256 -0
  200. package/dist/resources/templates/go-backend/go.sum +805 -0
  201. package/dist/resources/templates/go-backend/internal/common/canonicaljson/canonical.go +370 -0
  202. package/dist/resources/templates/go-backend/internal/common/canonicaljson/canonical_test.go +223 -0
  203. package/dist/resources/templates/go-backend/internal/common/checkoutbff/contracts.go +125 -0
  204. package/dist/resources/templates/go-backend/internal/common/checkoutbff/platform_client.go +212 -0
  205. package/dist/resources/templates/go-backend/internal/common/checkoutbff/platform_client_test.go +319 -0
  206. package/dist/resources/templates/go-backend/internal/common/contentaccess/contentaccess.go +50 -0
  207. package/dist/resources/templates/go-backend/internal/common/contracts/contact.go +85 -0
  208. package/dist/resources/templates/go-backend/internal/common/ctxutil/identity.go +20 -0
  209. package/dist/resources/templates/go-backend/internal/common/ctxutil/product.go +53 -0
  210. package/dist/resources/templates/go-backend/internal/common/enumdomain/payment.go +12 -0
  211. package/dist/resources/templates/go-backend/internal/common/enums/dto_admin.go +9 -0
  212. package/dist/resources/templates/go-backend/internal/common/enums/enum.go +1247 -0
  213. package/dist/resources/templates/go-backend/internal/common/enums/handler_admin.go +66 -0
  214. package/dist/resources/templates/go-backend/internal/common/enums/module.go +46 -0
  215. package/dist/resources/templates/go-backend/internal/common/enums/provider.go +10 -0
  216. package/dist/resources/templates/go-backend/internal/common/enums/register.go +11 -0
  217. package/dist/resources/templates/go-backend/internal/common/enums/register_audit.go +274 -0
  218. package/dist/resources/templates/go-backend/internal/common/enums/register_command_replay.go +12 -0
  219. package/dist/resources/templates/go-backend/internal/common/enums/register_config.go +27 -0
  220. package/dist/resources/templates/go-backend/internal/common/enums/register_locale.go +37 -0
  221. package/dist/resources/templates/go-backend/internal/common/enums/register_ops.go +14 -0
  222. package/dist/resources/templates/go-backend/internal/common/enums/register_outbox.go +15 -0
  223. package/dist/resources/templates/go-backend/internal/common/enums/register_rule_expression.go +63 -0
  224. package/dist/resources/templates/go-backend/internal/common/enums/registry.go +77 -0
  225. package/dist/resources/templates/go-backend/internal/common/httporigin/origin.go +62 -0
  226. package/dist/resources/templates/go-backend/internal/common/httporigin/origin_test.go +38 -0
  227. package/dist/resources/templates/go-backend/internal/common/iamcredential/plaintext.go +35 -0
  228. package/dist/resources/templates/go-backend/internal/common/iamcredential/plaintext_test.go +29 -0
  229. package/dist/resources/templates/go-backend/internal/common/iamscope/scope.go +212 -0
  230. package/dist/resources/templates/go-backend/internal/common/iamscope/scope_binding.go +26 -0
  231. package/dist/resources/templates/go-backend/internal/common/iamscope/scope_filter.go +173 -0
  232. package/dist/resources/templates/go-backend/internal/common/iamscope/scope_filter_test.go +279 -0
  233. package/dist/resources/templates/go-backend/internal/common/internalapi/authorization_details.go +10 -0
  234. package/dist/resources/templates/go-backend/internal/common/internalapi/route_permission_policies.go +660 -0
  235. package/dist/resources/templates/go-backend/internal/common/internalapi/route_permission_policies_test.go +331 -0
  236. package/dist/resources/templates/go-backend/internal/common/internalservice/audience_token_source.go +166 -0
  237. package/dist/resources/templates/go-backend/internal/common/internalservice/bootstrap_token_exchanger.go +183 -0
  238. package/dist/resources/templates/go-backend/internal/common/internalservice/bound_service_token_signer.go +52 -0
  239. package/dist/resources/templates/go-backend/internal/common/internalservice/delegated_access_token_exchanger.go +189 -0
  240. package/dist/resources/templates/go-backend/internal/common/internalservice/delegated_access_token_exchanger_test.go +159 -0
  241. package/dist/resources/templates/go-backend/internal/common/internalservice/product_scoped_service_token_signer.go +92 -0
  242. package/dist/resources/templates/go-backend/internal/common/internalservice/provider.go +25 -0
  243. package/dist/resources/templates/go-backend/internal/common/internalservice/request_signer.go +86 -0
  244. package/dist/resources/templates/go-backend/internal/common/internalservice/resolver.go +69 -0
  245. package/dist/resources/templates/go-backend/internal/common/internalservice/resolver_test.go +42 -0
  246. package/dist/resources/templates/go-backend/internal/common/internalservice/route_scope.go +95 -0
  247. package/dist/resources/templates/go-backend/internal/common/internalservice/route_scope_test.go +78 -0
  248. package/dist/resources/templates/go-backend/internal/common/internalservice/service_identity_test.go +387 -0
  249. package/dist/resources/templates/go-backend/internal/common/jsonschema/compiler.go +100 -0
  250. package/dist/resources/templates/go-backend/internal/common/jsonschema/compiler_test.go +41 -0
  251. package/dist/resources/templates/go-backend/internal/common/jwksapi/handler.go +83 -0
  252. package/dist/resources/templates/go-backend/internal/common/jwksapi/handler_test.go +104 -0
  253. package/dist/resources/templates/go-backend/internal/common/locale/locale.go +145 -0
  254. package/dist/resources/templates/go-backend/internal/common/locale/locale_test.go +75 -0
  255. package/dist/resources/templates/go-backend/internal/common/mediaref/mediaref.go +54 -0
  256. package/dist/resources/templates/go-backend/internal/common/mediaref/mediaref_test.go +77 -0
  257. package/dist/resources/templates/go-backend/internal/common/middleware/apikey_auth.go +320 -0
  258. package/dist/resources/templates/go-backend/internal/common/middleware/apikey_throttle.go +158 -0
  259. package/dist/resources/templates/go-backend/internal/common/middleware/auth.go +40 -0
  260. package/dist/resources/templates/go-backend/internal/common/middleware/auth_test.go +50 -0
  261. package/dist/resources/templates/go-backend/internal/common/middleware/client_context.go +86 -0
  262. package/dist/resources/templates/go-backend/internal/common/middleware/cors.go +68 -0
  263. package/dist/resources/templates/go-backend/internal/common/middleware/event_context.go +18 -0
  264. package/dist/resources/templates/go-backend/internal/common/middleware/gateway_identity.go +279 -0
  265. package/dist/resources/templates/go-backend/internal/common/middleware/helpers.go +159 -0
  266. package/dist/resources/templates/go-backend/internal/common/middleware/iam_delegated_route_permission.go +171 -0
  267. package/dist/resources/templates/go-backend/internal/common/middleware/iam_delegated_token_auth.go +151 -0
  268. package/dist/resources/templates/go-backend/internal/common/middleware/iam_delegated_token_auth_test.go +99 -0
  269. package/dist/resources/templates/go-backend/internal/common/middleware/iam_service_identity.go +138 -0
  270. package/dist/resources/templates/go-backend/internal/common/middleware/iam_service_token_auth.go +74 -0
  271. package/dist/resources/templates/go-backend/internal/common/middleware/idempotent.go +273 -0
  272. package/dist/resources/templates/go-backend/internal/common/middleware/idempotent_test.go +83 -0
  273. package/dist/resources/templates/go-backend/internal/common/middleware/internal_route_permission.go +45 -0
  274. package/dist/resources/templates/go-backend/internal/common/middleware/internal_route_permission_test.go +186 -0
  275. package/dist/resources/templates/go-backend/internal/common/middleware/logging.go +191 -0
  276. package/dist/resources/templates/go-backend/internal/common/middleware/metrics.go +45 -0
  277. package/dist/resources/templates/go-backend/internal/common/middleware/middleware_test.go +1516 -0
  278. package/dist/resources/templates/go-backend/internal/common/middleware/principal_context.go +160 -0
  279. package/dist/resources/templates/go-backend/internal/common/middleware/principal_context_test.go +355 -0
  280. package/dist/resources/templates/go-backend/internal/common/middleware/product_context.go +100 -0
  281. package/dist/resources/templates/go-backend/internal/common/middleware/recovery.go +40 -0
  282. package/dist/resources/templates/go-backend/internal/common/middleware/referral_attribution.go +178 -0
  283. package/dist/resources/templates/go-backend/internal/common/middleware/requestid.go +48 -0
  284. package/dist/resources/templates/go-backend/internal/common/middleware/resource_permission.go +790 -0
  285. package/dist/resources/templates/go-backend/internal/common/middleware/resource_permission_test.go +440 -0
  286. package/dist/resources/templates/go-backend/internal/common/middleware/service_credential_auth.go +67 -0
  287. package/dist/resources/templates/go-backend/internal/common/middleware/tenant.go +148 -0
  288. package/dist/resources/templates/go-backend/internal/common/middleware/throttle.go +310 -0
  289. package/dist/resources/templates/go-backend/internal/common/middleware/trusted_client_ip.go +23 -0
  290. package/dist/resources/templates/go-backend/internal/common/middleware/trusted_client_ip_test.go +60 -0
  291. package/dist/resources/templates/go-backend/internal/common/money/currency.go +25 -0
  292. package/dist/resources/templates/go-backend/internal/common/money/errors.go +23 -0
  293. package/dist/resources/templates/go-backend/internal/common/money/format.go +123 -0
  294. package/dist/resources/templates/go-backend/internal/common/money/format_test.go +204 -0
  295. package/dist/resources/templates/go-backend/internal/common/money/gateway.go +144 -0
  296. package/dist/resources/templates/go-backend/internal/common/money/gateway_test.go +165 -0
  297. package/dist/resources/templates/go-backend/internal/common/money/rounding.go +56 -0
  298. package/dist/resources/templates/go-backend/internal/common/money/rounding_test.go +51 -0
  299. package/dist/resources/templates/go-backend/internal/common/principal/context.go +56 -0
  300. package/dist/resources/templates/go-backend/internal/common/principal/principal.go +49 -0
  301. package/dist/resources/templates/go-backend/internal/common/productcode/code.go +24 -0
  302. package/dist/resources/templates/go-backend/internal/common/productcode/code_test.go +35 -0
  303. package/dist/resources/templates/go-backend/internal/common/providerconfig/schema.go +577 -0
  304. package/dist/resources/templates/go-backend/internal/common/providerconfig/schema_test.go +47 -0
  305. package/dist/resources/templates/go-backend/internal/common/requestprivacy/request.go +246 -0
  306. package/dist/resources/templates/go-backend/internal/common/requestprivacy/request_test.go +170 -0
  307. package/dist/resources/templates/go-backend/internal/common/response/pagination.go +60 -0
  308. package/dist/resources/templates/go-backend/internal/common/response/response.go +110 -0
  309. package/dist/resources/templates/go-backend/internal/common/response/response_test.go +463 -0
  310. package/dist/resources/templates/go-backend/internal/common/ruleexpression/ast.go +141 -0
  311. package/dist/resources/templates/go-backend/internal/common/ruleexpression/ast_test.go +81 -0
  312. package/dist/resources/templates/go-backend/internal/common/ruleexpression/canonical.go +184 -0
  313. package/dist/resources/templates/go-backend/internal/common/ruleexpression/canonical_test.go +319 -0
  314. package/dist/resources/templates/go-backend/internal/common/ruleexpression/decoder.go +555 -0
  315. package/dist/resources/templates/go-backend/internal/common/ruleexpression/decoder_test.go +260 -0
  316. package/dist/resources/templates/go-backend/internal/common/ruleexpression/errors.go +55 -0
  317. package/dist/resources/templates/go-backend/internal/common/ruleexpression/evaluator.go +96 -0
  318. package/dist/resources/templates/go-backend/internal/common/ruleexpression/evaluator_test.go +220 -0
  319. package/dist/resources/templates/go-backend/internal/common/ruleexpression/fuzz_test.go +116 -0
  320. package/dist/resources/templates/go-backend/internal/common/ruleexpression/limits.go +331 -0
  321. package/dist/resources/templates/go-backend/internal/common/ruleexpression/schema.go +412 -0
  322. package/dist/resources/templates/go-backend/internal/common/ruleexpression/schema_test.go +164 -0
  323. package/dist/resources/templates/go-backend/internal/common/runtimeinput/runtime_input.go +627 -0
  324. package/dist/resources/templates/go-backend/internal/common/runtimeinput/runtime_input_test.go +245 -0
  325. package/dist/resources/templates/go-backend/internal/common/semver/errors.go +6 -0
  326. package/dist/resources/templates/go-backend/internal/common/semver/semver.go +125 -0
  327. package/dist/resources/templates/go-backend/internal/common/semver/semver_test.go +205 -0
  328. package/dist/resources/templates/go-backend/internal/common/serviceidentity/audience.go +48 -0
  329. package/dist/resources/templates/go-backend/internal/common/serviceidentity/audience_test.go +35 -0
  330. package/dist/resources/templates/go-backend/internal/common/serviceidentity/resource_identifier.go +33 -0
  331. package/dist/resources/templates/go-backend/internal/common/serviceidentity/resource_identifier_test.go +32 -0
  332. package/dist/resources/templates/go-backend/internal/common/tradeno/generator.go +99 -0
  333. package/dist/resources/templates/go-backend/internal/common/tradeno/generator_test.go +396 -0
  334. package/dist/resources/templates/go-backend/internal/common/tradeno/prefix.go +247 -0
  335. package/dist/resources/templates/go-backend/internal/common/types/asset_url.go +11 -0
  336. package/dist/resources/templates/go-backend/internal/common/types/billing.go +89 -0
  337. package/dist/resources/templates/go-backend/internal/common/types/billing_test.go +77 -0
  338. package/dist/resources/templates/go-backend/internal/common/types/country.go +74 -0
  339. package/dist/resources/templates/go-backend/internal/common/types/country_test.go +28 -0
  340. package/dist/resources/templates/go-backend/internal/common/types/currency.go +60 -0
  341. package/dist/resources/templates/go-backend/internal/common/types/identifiers.go +41 -0
  342. package/dist/resources/templates/go-backend/internal/common/types/operator.go +28 -0
  343. package/dist/resources/templates/go-backend/internal/common/types/subscription_entitlement.go +24 -0
  344. package/dist/resources/templates/go-backend/internal/common/types/subscription_entitlement_test.go +35 -0
  345. package/dist/resources/templates/go-backend/internal/common/types/tier.go +72 -0
  346. package/dist/resources/templates/go-backend/internal/common/types/types.go +411 -0
  347. package/dist/resources/templates/go-backend/internal/common/types/types_test.go +295 -0
  348. package/dist/resources/templates/go-backend/internal/common/utils/constants.go +100 -0
  349. package/dist/resources/templates/go-backend/internal/common/utils/crypto.go +158 -0
  350. package/dist/resources/templates/go-backend/internal/common/utils/crypto_test.go +345 -0
  351. package/dist/resources/templates/go-backend/internal/common/utils/duration.go +25 -0
  352. package/dist/resources/templates/go-backend/internal/common/utils/helpers.go +18 -0
  353. package/dist/resources/templates/go-backend/internal/common/utils/json.go +62 -0
  354. package/dist/resources/templates/go-backend/internal/common/utils/json_test.go +76 -0
  355. package/dist/resources/templates/go-backend/internal/common/utils/pagination.go +51 -0
  356. package/dist/resources/templates/go-backend/internal/common/utils/pagination_test.go +45 -0
  357. package/dist/resources/templates/go-backend/internal/common/utils/pointer.go +107 -0
  358. package/dist/resources/templates/go-backend/internal/common/utils/pointer_test.go +15 -0
  359. package/dist/resources/templates/go-backend/internal/common/utils/slice.go +24 -0
  360. package/dist/resources/templates/go-backend/internal/common/utils/snowflake.go +110 -0
  361. package/dist/resources/templates/go-backend/internal/common/utils/snowflake_test.go +316 -0
  362. package/dist/resources/templates/go-backend/internal/common/utils/string.go +16 -0
  363. package/dist/resources/templates/go-backend/internal/common/utils/timefmt.go +42 -0
  364. package/dist/resources/templates/go-backend/internal/common/validator/validator.go +136 -0
  365. package/dist/resources/templates/go-backend/internal/common/validator/validator_test.go +240 -0
  366. package/dist/resources/templates/go-backend/internal/common/youtubeapi/client.go +224 -0
  367. package/dist/resources/templates/go-backend/internal/core/apicontract/document.go +269 -0
  368. package/dist/resources/templates/go-backend/internal/core/apicontract/document_test.go +104 -0
  369. package/dist/resources/templates/go-backend/internal/core/apicontract/route_validator.go +78 -0
  370. package/dist/resources/templates/go-backend/internal/core/apicontract/route_validator_test.go +108 -0
  371. package/dist/resources/templates/go-backend/internal/core/apidocs/assets/scalar-api-reference.js +2385 -0
  372. package/dist/resources/templates/go-backend/internal/core/apidocs/assets/scalar-api-reference.metadata.json +10 -0
  373. package/dist/resources/templates/go-backend/internal/core/apidocs/route.go +107 -0
  374. package/dist/resources/templates/go-backend/internal/core/apidocs/route_test.go +200 -0
  375. package/dist/resources/templates/go-backend/internal/core/apidocs/scalar.go +117 -0
  376. package/dist/resources/templates/go-backend/internal/core/apidocs/scalar_test.go +99 -0
  377. package/dist/resources/templates/go-backend/internal/core/audit/access_log_policy.go +91 -0
  378. package/dist/resources/templates/go-backend/internal/core/audit/access_log_policy_test.go +51 -0
  379. package/dist/resources/templates/go-backend/internal/core/audit/actor_resolver.go +36 -0
  380. package/dist/resources/templates/go-backend/internal/core/audit/constants.go +30 -0
  381. package/dist/resources/templates/go-backend/internal/core/audit/context.go +119 -0
  382. package/dist/resources/templates/go-backend/internal/core/audit/context_test.go +310 -0
  383. package/dist/resources/templates/go-backend/internal/core/audit/dto.go +468 -0
  384. package/dist/resources/templates/go-backend/internal/core/audit/dto_admin.go +172 -0
  385. package/dist/resources/templates/go-backend/internal/core/audit/enum.go +460 -0
  386. package/dist/resources/templates/go-backend/internal/core/audit/enum_test.go +314 -0
  387. package/dist/resources/templates/go-backend/internal/core/audit/errors.go +9 -0
  388. package/dist/resources/templates/go-backend/internal/core/audit/handler.go +568 -0
  389. package/dist/resources/templates/go-backend/internal/core/audit/listener.go +319 -0
  390. package/dist/resources/templates/go-backend/internal/core/audit/listener_test.go +98 -0
  391. package/dist/resources/templates/go-backend/internal/core/audit/middleware.go +669 -0
  392. package/dist/resources/templates/go-backend/internal/core/audit/middleware_test.go +268 -0
  393. package/dist/resources/templates/go-backend/internal/core/audit/model.go +306 -0
  394. package/dist/resources/templates/go-backend/internal/core/audit/partition_job.go +316 -0
  395. package/dist/resources/templates/go-backend/internal/core/audit/ports.go +9 -0
  396. package/dist/resources/templates/go-backend/internal/core/audit/provider.go +30 -0
  397. package/dist/resources/templates/go-backend/internal/core/audit/repository.go +1007 -0
  398. package/dist/resources/templates/go-backend/internal/core/audit/repository_test.go +934 -0
  399. package/dist/resources/templates/go-backend/internal/core/audit/router.go +85 -0
  400. package/dist/resources/templates/go-backend/internal/core/audit/service.go +770 -0
  401. package/dist/resources/templates/go-backend/internal/core/audit/service_test.go +331 -0
  402. package/dist/resources/templates/go-backend/internal/core/audit/vo_admin.go +475 -0
  403. package/dist/resources/templates/go-backend/internal/core/cache/config.go +30 -0
  404. package/dist/resources/templates/go-backend/internal/core/cache/key.go +41 -0
  405. package/dist/resources/templates/go-backend/internal/core/cache/key_test.go +62 -0
  406. package/dist/resources/templates/go-backend/internal/core/cache/l1.go +153 -0
  407. package/dist/resources/templates/go-backend/internal/core/cache/l1_test.go +212 -0
  408. package/dist/resources/templates/go-backend/internal/core/cache/manager.go +278 -0
  409. package/dist/resources/templates/go-backend/internal/core/cache/manager_provider.go +24 -0
  410. package/dist/resources/templates/go-backend/internal/core/cache/metrics.go +126 -0
  411. package/dist/resources/templates/go-backend/internal/core/cache/namespace.go +46 -0
  412. package/dist/resources/templates/go-backend/internal/core/cache/namespace_test.go +90 -0
  413. package/dist/resources/templates/go-backend/internal/core/cache/options.go +39 -0
  414. package/dist/resources/templates/go-backend/internal/core/cache/options_test.go +96 -0
  415. package/dist/resources/templates/go-backend/internal/core/cache/redis.go +311 -0
  416. package/dist/resources/templates/go-backend/internal/core/cache/redis_test.go +51 -0
  417. package/dist/resources/templates/go-backend/internal/core/cache/serializer.go +31 -0
  418. package/dist/resources/templates/go-backend/internal/core/cache/serializer_test.go +139 -0
  419. package/dist/resources/templates/go-backend/internal/core/cache/singleflight.go +53 -0
  420. package/dist/resources/templates/go-backend/internal/core/cache/singleflight_test.go +211 -0
  421. package/dist/resources/templates/go-backend/internal/core/cache/warming.go +86 -0
  422. package/dist/resources/templates/go-backend/internal/core/clock/clock.go +66 -0
  423. package/dist/resources/templates/go-backend/internal/core/clock/clock_test.go +26 -0
  424. package/dist/resources/templates/go-backend/internal/core/clock/runtime_clock.go +283 -0
  425. package/dist/resources/templates/go-backend/internal/core/clock/runtime_clock_test.go +98 -0
  426. package/dist/resources/templates/go-backend/internal/core/commandreplay/errors.go +6 -0
  427. package/dist/resources/templates/go-backend/internal/core/commandreplay/model.go +90 -0
  428. package/dist/resources/templates/go-backend/internal/core/commandreplay/model_test.go +79 -0
  429. package/dist/resources/templates/go-backend/internal/core/commandreplay/namespace.go +7 -0
  430. package/dist/resources/templates/go-backend/internal/core/commandreplay/persistence.go +269 -0
  431. package/dist/resources/templates/go-backend/internal/core/commandreplay/persistence_test.go +185 -0
  432. package/dist/resources/templates/go-backend/internal/core/commandreplay/provider.go +9 -0
  433. package/dist/resources/templates/go-backend/internal/core/commandreplay/repository.go +22 -0
  434. package/dist/resources/templates/go-backend/internal/core/commandreplay/service.go +853 -0
  435. package/dist/resources/templates/go-backend/internal/core/commandreplay/service_persistence_test.go +432 -0
  436. package/dist/resources/templates/go-backend/internal/core/commandreplay/service_test.go +891 -0
  437. package/dist/resources/templates/go-backend/internal/core/commandreplay/types.go +121 -0
  438. package/dist/resources/templates/go-backend/internal/core/config/config.go +2069 -0
  439. package/dist/resources/templates/go-backend/internal/core/config/config_test.go +1122 -0
  440. package/dist/resources/templates/go-backend/internal/core/config/contract/contract_test.go +388 -0
  441. package/dist/resources/templates/go-backend/internal/core/config/contract/docs.go +198 -0
  442. package/dist/resources/templates/go-backend/internal/core/config/contract/verify.go +424 -0
  443. package/dist/resources/templates/go-backend/internal/core/config/enum.go +46 -0
  444. package/dist/resources/templates/go-backend/internal/core/config/metadata.go +717 -0
  445. package/dist/resources/templates/go-backend/internal/core/config/metadata_test.go +228 -0
  446. package/dist/resources/templates/go-backend/internal/core/config/product_admin_config_test.go +210 -0
  447. package/dist/resources/templates/go-backend/internal/core/crypto/aes_gcm.go +111 -0
  448. package/dist/resources/templates/go-backend/internal/core/crypto/aes_gcm_test.go +364 -0
  449. package/dist/resources/templates/go-backend/internal/core/crypto/encryptor.go +12 -0
  450. package/dist/resources/templates/go-backend/internal/core/crypto/envelope_encryptor.go +134 -0
  451. package/dist/resources/templates/go-backend/internal/core/crypto/envelope_encryptor_test.go +118 -0
  452. package/dist/resources/templates/go-backend/internal/core/crypto/pem.go +112 -0
  453. package/dist/resources/templates/go-backend/internal/core/crypto/pem_test.go +44 -0
  454. package/dist/resources/templates/go-backend/internal/core/crypto/provider.go +130 -0
  455. package/dist/resources/templates/go-backend/internal/core/crypto/provider_test.go +92 -0
  456. package/dist/resources/templates/go-backend/internal/core/database/base_model.go +24 -0
  457. package/dist/resources/templates/go-backend/internal/core/database/clickhouse.go +121 -0
  458. package/dist/resources/templates/go-backend/internal/core/database/database.go +112 -0
  459. package/dist/resources/templates/go-backend/internal/core/database/database_logger_test.go +95 -0
  460. package/dist/resources/templates/go-backend/internal/core/database/errors.go +25 -0
  461. package/dist/resources/templates/go-backend/internal/core/database/metrics_plugin.go +105 -0
  462. package/dist/resources/templates/go-backend/internal/core/database/pool_collector.go +71 -0
  463. package/dist/resources/templates/go-backend/internal/core/database/read_replica.go +520 -0
  464. package/dist/resources/templates/go-backend/internal/core/database/transaction.go +170 -0
  465. package/dist/resources/templates/go-backend/internal/core/database/transaction_test.go +282 -0
  466. package/dist/resources/templates/go-backend/internal/core/distlock/lock.go +353 -0
  467. package/dist/resources/templates/go-backend/internal/core/distlock/lock_test.go +106 -0
  468. package/dist/resources/templates/go-backend/internal/core/errors/handler.go +189 -0
  469. package/dist/resources/templates/go-backend/internal/core/errors/handler_test.go +515 -0
  470. package/dist/resources/templates/go-backend/internal/core/eventbus/eventbus.go +667 -0
  471. package/dist/resources/templates/go-backend/internal/core/eventbus/eventbus_test.go +792 -0
  472. package/dist/resources/templates/go-backend/internal/core/eventstream/noop.go +22 -0
  473. package/dist/resources/templates/go-backend/internal/core/eventstream/provider.go +20 -0
  474. package/dist/resources/templates/go-backend/internal/core/eventstream/publisher.go +38 -0
  475. package/dist/resources/templates/go-backend/internal/core/eventstream/redis.go +109 -0
  476. package/dist/resources/templates/go-backend/internal/core/eventstream/routing.go +104 -0
  477. package/dist/resources/templates/go-backend/internal/core/eventstream/routing_test.go +71 -0
  478. package/dist/resources/templates/go-backend/internal/core/geoip/model.go +19 -0
  479. package/dist/resources/templates/go-backend/internal/core/geoip/service.go +88 -0
  480. package/dist/resources/templates/go-backend/internal/core/health/health.go +333 -0
  481. package/dist/resources/templates/go-backend/internal/core/health/health_test.go +27 -0
  482. package/dist/resources/templates/go-backend/internal/core/httpclient/client.go +772 -0
  483. package/dist/resources/templates/go-backend/internal/core/httpclient/client_test.go +287 -0
  484. package/dist/resources/templates/go-backend/internal/core/httpclient/download.go +578 -0
  485. package/dist/resources/templates/go-backend/internal/core/httpclient/download_test.go +374 -0
  486. package/dist/resources/templates/go-backend/internal/core/jwtkeyring/jwk.go +38 -0
  487. package/dist/resources/templates/go-backend/internal/core/jwtkeyring/keyring.go +144 -0
  488. package/dist/resources/templates/go-backend/internal/core/jwtkeyring/keyring_test.go +128 -0
  489. package/dist/resources/templates/go-backend/internal/core/jwtkeyring/registry.go +60 -0
  490. package/dist/resources/templates/go-backend/internal/core/logger/logger.go +53 -0
  491. package/dist/resources/templates/go-backend/internal/core/logger/logger_test.go +194 -0
  492. package/dist/resources/templates/go-backend/internal/core/observability/metrics.go +358 -0
  493. package/dist/resources/templates/go-backend/internal/core/observability/sentry.go +445 -0
  494. package/dist/resources/templates/go-backend/internal/core/observability/sentry_privacy_test.go +175 -0
  495. package/dist/resources/templates/go-backend/internal/core/observability/tracing.go +187 -0
  496. package/dist/resources/templates/go-backend/internal/core/outbox/model.go +314 -0
  497. package/dist/resources/templates/go-backend/internal/core/outbox/model_test.go +77 -0
  498. package/dist/resources/templates/go-backend/internal/core/outbox/persistence.go +51 -0
  499. package/dist/resources/templates/go-backend/internal/core/outbox/provider.go +23 -0
  500. package/dist/resources/templates/go-backend/internal/core/outbox/relay.go +1138 -0
  501. package/dist/resources/templates/go-backend/internal/core/outbox/relay_postgres_test.go +257 -0
  502. package/dist/resources/templates/go-backend/internal/core/outbox/relay_test.go +690 -0
  503. package/dist/resources/templates/go-backend/internal/core/outbox/rescheduler.go +164 -0
  504. package/dist/resources/templates/go-backend/internal/core/outbox/rescheduler_test.go +209 -0
  505. package/dist/resources/templates/go-backend/internal/core/outbox/writer.go +249 -0
  506. package/dist/resources/templates/go-backend/internal/core/outbox/writer_postgres_test.go +170 -0
  507. package/dist/resources/templates/go-backend/internal/core/outbox/writer_test.go +123 -0
  508. package/dist/resources/templates/go-backend/internal/core/provider.go +198 -0
  509. package/dist/resources/templates/go-backend/internal/core/queue/metrics_middleware.go +38 -0
  510. package/dist/resources/templates/go-backend/internal/core/queue/metrics_middleware_test.go +12 -0
  511. package/dist/resources/templates/go-backend/internal/core/queue/queue.go +288 -0
  512. package/dist/resources/templates/go-backend/internal/core/queue/queue_test.go +159 -0
  513. package/dist/resources/templates/go-backend/internal/core/resilience/bulkhead.go +514 -0
  514. package/dist/resources/templates/go-backend/internal/core/resilience/bulkhead_test.go +984 -0
  515. package/dist/resources/templates/go-backend/internal/core/resilience/circuitbreaker.go +358 -0
  516. package/dist/resources/templates/go-backend/internal/core/resilience/circuitbreaker_test.go +788 -0
  517. package/dist/resources/templates/go-backend/internal/core/resilience/retry.go +318 -0
  518. package/dist/resources/templates/go-backend/internal/core/resilience/retry_test.go +735 -0
  519. package/dist/resources/templates/go-backend/internal/core/schedule/recorder.go +305 -0
  520. package/dist/resources/templates/go-backend/internal/core/schedule/run_context.go +124 -0
  521. package/dist/resources/templates/go-backend/internal/core/schedule/run_context_test.go +85 -0
  522. package/dist/resources/templates/go-backend/internal/core/schedule/scheduler.go +1589 -0
  523. package/dist/resources/templates/go-backend/internal/core/schedule/scheduler_control_test.go +808 -0
  524. package/dist/resources/templates/go-backend/internal/core/storage/oss_provider.go +398 -0
  525. package/dist/resources/templates/go-backend/internal/core/storage/oss_provider_test.go +89 -0
  526. package/dist/resources/templates/go-backend/internal/core/storage/path.go +110 -0
  527. package/dist/resources/templates/go-backend/internal/core/storage/path_test.go +301 -0
  528. package/dist/resources/templates/go-backend/internal/core/storage/s3_provider.go +489 -0
  529. package/dist/resources/templates/go-backend/internal/core/storage/s3_provider_test.go +60 -0
  530. package/dist/resources/templates/go-backend/internal/core/storage/storage.go +268 -0
  531. package/dist/resources/templates/go-backend/internal/core/storage/validation.go +225 -0
  532. package/dist/resources/templates/go-backend/internal/core/storage/validation_test.go +495 -0
  533. package/dist/resources/templates/go-backend/internal/core/temporal/logger.go +38 -0
  534. package/dist/resources/templates/go-backend/internal/core/temporal/provider.go +126 -0
  535. package/dist/resources/templates/go-backend/internal/core/temporal/provider_test.go +67 -0
  536. package/dist/resources/templates/go-backend/internal/core/websocket/client.go +282 -0
  537. package/dist/resources/templates/go-backend/internal/core/websocket/client_test.go +81 -0
  538. package/dist/resources/templates/go-backend/internal/core/websocket/config.go +58 -0
  539. package/dist/resources/templates/go-backend/internal/core/websocket/handler.go +53 -0
  540. package/dist/resources/templates/go-backend/internal/core/websocket/hub.go +269 -0
  541. package/dist/resources/templates/go-backend/internal/core/websocket/message.go +273 -0
  542. package/dist/resources/templates/go-backend/internal/core/websocket/notifier.go +92 -0
  543. package/dist/resources/templates/go-backend/internal/core/websocket/provider.go +33 -0
  544. package/dist/resources/templates/go-backend/internal/integrations/onex/iam/action.go +77 -0
  545. package/dist/resources/templates/go-backend/internal/integrations/onex/iam/action_test.go +238 -0
  546. package/dist/resources/templates/go-backend/internal/integrations/onex/iam/condition.go +107 -0
  547. package/dist/resources/templates/go-backend/internal/integrations/onex/iam/decision.go +256 -0
  548. package/dist/resources/templates/go-backend/internal/integrations/onex/iam/enum.go +643 -0
  549. package/dist/resources/templates/go-backend/internal/integrations/onex/iam/errors.go +102 -0
  550. package/dist/resources/templates/go-backend/internal/integrations/onex/iam/principal_record.go +21 -0
  551. package/dist/resources/templates/go-backend/internal/integrations/onex/iam/product_context.go +486 -0
  552. package/dist/resources/templates/go-backend/internal/integrations/onex/iam/resource.go +215 -0
  553. package/dist/resources/templates/go-backend/internal/integrations/onex/iam/resource_test.go +242 -0
  554. package/dist/resources/templates/go-backend/internal/products/README.md +5 -0
  555. package/dist/resources/templates/go-backend/internal/sharedevents/README.md +5 -0
  556. package/dist/resources/templates/go-backend/migrations/000001_infrastructure.down.sql +13 -0
  557. package/dist/resources/templates/go-backend/migrations/000001_infrastructure.up.sql +886 -0
  558. package/dist/resources/templates/go-backend/pkg/apierror/error.go +327 -0
  559. package/dist/resources/templates/go-backend/pkg/apierror/error_code.go +65 -0
  560. package/dist/resources/templates/go-backend/pkg/apierror/error_test.go +41 -0
  561. package/dist/resources/templates/go-backend/pkg/apierror/error_type.go +14 -0
  562. package/dist/resources/templates/go-backend/pkg/apierror/http_response.go +216 -0
  563. package/dist/resources/templates/go-backend/pkg/apierror/http_response_test.go +216 -0
  564. package/dist/resources/templates/go-backend/scripts/check-openapi-clean-deletion.sh +54 -0
  565. package/dist/resources/templates/go-backend/scripts/test-migrations.sh +32 -0
  566. package/dist/resources/templates/go-backend/tests/infrastructure.sql +69 -0
  567. package/dist/resources/templates/mcp-server/.claude/docs/stack.md +338 -0
  568. package/dist/resources/templates/mcp-server/.editorconfig +13 -0
  569. package/dist/resources/templates/mcp-server/.env.example +8 -0
  570. package/dist/resources/templates/mcp-server/.github/ISSUE_TEMPLATE/bug_report.yml +104 -0
  571. package/dist/resources/templates/mcp-server/.github/ISSUE_TEMPLATE/feature_request.yml +54 -0
  572. package/dist/resources/templates/mcp-server/.github/PULL_REQUEST_TEMPLATE.md +36 -0
  573. package/dist/resources/templates/mcp-server/.github/workflows/ci.yml +78 -0
  574. package/dist/resources/templates/mcp-server/.husky/commit-msg +1 -0
  575. package/dist/resources/templates/mcp-server/.husky/pre-commit +1 -0
  576. package/dist/resources/templates/mcp-server/.lintstagedrc.json +4 -0
  577. package/dist/resources/templates/mcp-server/.nvmrc +1 -0
  578. package/dist/resources/templates/mcp-server/.prettierrc +8 -0
  579. package/dist/resources/templates/mcp-server/CONTRIBUTING.md +184 -0
  580. package/dist/resources/templates/mcp-server/Dockerfile +23 -0
  581. package/dist/resources/templates/mcp-server/LICENSE +21 -0
  582. package/dist/resources/templates/mcp-server/README.md +123 -0
  583. package/dist/resources/templates/mcp-server/_gitignore +26 -0
  584. package/dist/resources/templates/mcp-server/commitlint.config.js +24 -0
  585. package/dist/resources/templates/mcp-server/eslint.config.js +30 -0
  586. package/dist/resources/templates/mcp-server/package.json +72 -0
  587. package/dist/resources/templates/mcp-server/src/index.ts +27 -0
  588. package/dist/resources/templates/mcp-server/src/resources.ts +33 -0
  589. package/dist/resources/templates/mcp-server/src/services/.gitkeep +0 -0
  590. package/dist/resources/templates/mcp-server/src/tools.ts +43 -0
  591. package/dist/resources/templates/mcp-server/src/types/index.ts +19 -0
  592. package/dist/resources/templates/mcp-server/src/utils/index.ts +31 -0
  593. package/dist/resources/templates/mcp-server/tsconfig.json +22 -0
  594. package/dist/resources/templates/mcp-server/tsup.config.ts +14 -0
  595. package/dist/resources/templates/mcp-server/vitest.config.ts +15 -0
  596. package/dist/resources/templates/nuxt/.claude/docs/stack.md +666 -0
  597. package/dist/resources/templates/nuxt/.editorconfig +15 -0
  598. package/dist/resources/templates/nuxt/.env.example +22 -0
  599. package/dist/resources/templates/nuxt/.github/workflows/ci.yml +34 -0
  600. package/dist/resources/templates/nuxt/.husky/commit-msg +1 -0
  601. package/dist/resources/templates/nuxt/.husky/pre-commit +1 -0
  602. package/dist/resources/templates/nuxt/.nvmrc +1 -0
  603. package/dist/resources/templates/nuxt/.prettierignore +9 -0
  604. package/dist/resources/templates/nuxt/.prettierrc +1 -0
  605. package/dist/resources/templates/nuxt/README.md +23 -0
  606. package/dist/resources/templates/nuxt/_gitignore +7 -0
  607. package/dist/resources/templates/nuxt/app/app.config.ts +105 -0
  608. package/dist/resources/templates/nuxt/app/i18n/locales/en.json +5 -0
  609. package/dist/resources/templates/nuxt/app/pages/app/index.vue +224 -0
  610. package/dist/resources/templates/nuxt/app/pages/authors/[slug].vue +37 -0
  611. package/dist/resources/templates/nuxt/app/pages/blog/[slug].vue +55 -0
  612. package/dist/resources/templates/nuxt/app/pages/blog/category/[category].vue +38 -0
  613. package/dist/resources/templates/nuxt/app/pages/blog/index.vue +46 -0
  614. package/dist/resources/templates/nuxt/app/pages/index.vue +626 -0
  615. package/dist/resources/templates/nuxt/app/pages/legal/privacy.vue +21 -0
  616. package/dist/resources/templates/nuxt/app/pages/legal/terms.vue +21 -0
  617. package/dist/resources/templates/nuxt/app/pages/ui/index.vue +397 -0
  618. package/dist/resources/templates/nuxt/commitlint.config.mjs +1 -0
  619. package/dist/resources/templates/nuxt/eslint.config.mjs +4 -0
  620. package/dist/resources/templates/nuxt/lint-staged.config.mjs +8 -0
  621. package/dist/resources/templates/nuxt/nuxt.config.ts +71 -0
  622. package/dist/resources/templates/nuxt/package.json +67 -0
  623. package/dist/resources/templates/nuxt/public/apple-touch-icon.png +0 -0
  624. package/dist/resources/templates/nuxt/public/favicon.ico +0 -0
  625. package/dist/resources/templates/nuxt/public/favicon.svg +5 -0
  626. package/dist/resources/templates/nuxt/public/icon-16x16.png +0 -0
  627. package/dist/resources/templates/nuxt/public/icon-192x192.png +0 -0
  628. package/dist/resources/templates/nuxt/public/icon-32x32.png +0 -0
  629. package/dist/resources/templates/nuxt/public/icon-512x512.png +0 -0
  630. package/dist/resources/templates/nuxt/public/logo.svg +6 -0
  631. package/dist/resources/templates/nuxt/public/media/hero-product-gallery.png +0 -0
  632. package/dist/resources/templates/nuxt/server/api/content/sitemap-urls.get.ts +12 -0
  633. package/dist/resources/templates/nuxt/server/api/preview.get.ts +9 -0
  634. package/dist/resources/templates/nuxt/stylelint.config.mjs +3 -0
  635. package/dist/resources/templates/nuxt/test/e2e/rendering.test.ts +13 -0
  636. package/dist/resources/templates/nuxt/tsconfig.json +3 -0
  637. package/dist/resources/templates/nuxt/vitest.config.ts +8 -0
  638. package/package.json +8 -5
@@ -0,0 +1,463 @@
1
+ package response
2
+
3
+ import (
4
+ "encoding/json"
5
+ "fmt"
6
+ "net/http"
7
+ "net/http/httptest"
8
+ "reflect"
9
+ "strings"
10
+ "testing"
11
+
12
+ "github.com/gin-gonic/gin"
13
+ "github.com/go-playground/validator/v10"
14
+ "github.com/stretchr/testify/assert"
15
+ "github.com/stretchr/testify/require"
16
+
17
+ "{{module}}/internal/common/types"
18
+ "{{module}}/pkg/apierror"
19
+ )
20
+
21
+ func init() {
22
+ gin.SetMode(gin.TestMode)
23
+ }
24
+
25
+ // newTestContext 创建用于测试的 gin.Context 和 httptest.ResponseRecorder
26
+ func newTestContext() (*gin.Context, *httptest.ResponseRecorder) {
27
+ w := httptest.NewRecorder()
28
+ c, _ := gin.CreateTestContext(w)
29
+ c.Request = httptest.NewRequest(http.MethodGet, "/", nil)
30
+ return c, w
31
+ }
32
+
33
+ // TestOK 验证 200 状态码和响应体
34
+ func TestOK(t *testing.T) {
35
+ tests := []struct {
36
+ name string
37
+ data any
38
+ }{
39
+ {
40
+ name: "返回 map 数据",
41
+ data: map[string]string{"id": "123", "name": "test"},
42
+ },
43
+ {
44
+ name: "返回 nil",
45
+ data: nil,
46
+ },
47
+ {
48
+ name: "返回字符串",
49
+ data: "hello",
50
+ },
51
+ }
52
+
53
+ for _, tc := range tests {
54
+ t.Run(tc.name, func(t *testing.T) {
55
+ c, w := newTestContext()
56
+ OK(c, tc.data)
57
+ assert.Equal(t, http.StatusOK, w.Code)
58
+ })
59
+ }
60
+ }
61
+
62
+ // TestCreated 验证 201 状态码和响应体
63
+ func TestCreated(t *testing.T) {
64
+ tests := []struct {
65
+ name string
66
+ data any
67
+ }{
68
+ {
69
+ name: "返回新建资源",
70
+ data: map[string]any{"id": 1, "name": "new-resource"},
71
+ },
72
+ {
73
+ name: "返回包含 ID 的结构体",
74
+ data: struct {
75
+ ID int64 `json:"id"`
76
+ Name string `json:"name"`
77
+ }{ID: 42, Name: "example"},
78
+ },
79
+ }
80
+
81
+ for _, tc := range tests {
82
+ t.Run(tc.name, func(t *testing.T) {
83
+ c, w := newTestContext()
84
+ Created(c, tc.data)
85
+ assert.Equal(t, http.StatusCreated, w.Code)
86
+
87
+ // 验证响应体是有效的 JSON
88
+ var body any
89
+ err := json.Unmarshal(w.Body.Bytes(), &body)
90
+ require.NoError(t, err, "响应体应为有效 JSON")
91
+ })
92
+ }
93
+ }
94
+
95
+ // TestNoContent 验证 204 状态码且无响应体
96
+ func TestNoContent(t *testing.T) {
97
+ c, w := newTestContext()
98
+ NoContent(c)
99
+ // gin 的 WriteHeader 只缓存状态码,须调用 WriteHeaderNow 才会写入 recorder
100
+ c.Writer.WriteHeaderNow()
101
+ assert.Equal(t, http.StatusNoContent, w.Code)
102
+ assert.Empty(t, w.Body.Bytes(), "204 响应不应有 body")
103
+ }
104
+
105
+ // TestError_APIError 验证 Error 对 *apierror.APIError 的状态码提取
106
+ func TestError_APIError(t *testing.T) {
107
+ tests := []struct {
108
+ name string
109
+ err error
110
+ wantStatus int
111
+ wantErrorCode string
112
+ wantErrorType string
113
+ }{
114
+ {
115
+ name: "404 NotFound",
116
+ err: apierror.NotFound("User", 1),
117
+ wantStatus: http.StatusNotFound,
118
+ wantErrorCode: apierror.CodeResourceNotFound,
119
+ wantErrorType: apierror.TypeNotFound,
120
+ },
121
+ {
122
+ name: "401 Unauthorized",
123
+ err: apierror.Unauthorized(),
124
+ wantStatus: http.StatusUnauthorized,
125
+ wantErrorCode: apierror.CodeUnauthorized,
126
+ wantErrorType: apierror.TypeAuthentication,
127
+ },
128
+ {
129
+ name: "403 Forbidden",
130
+ err: apierror.Forbidden(),
131
+ wantStatus: http.StatusForbidden,
132
+ wantErrorCode: apierror.CodeAccessDenied,
133
+ wantErrorType: apierror.TypeAuthorization,
134
+ },
135
+ {
136
+ name: "409 Conflict",
137
+ err: apierror.AlreadyExists("Email", "email"),
138
+ wantStatus: http.StatusConflict,
139
+ wantErrorCode: apierror.CodeResourceExists,
140
+ wantErrorType: apierror.TypeInvalidRequest,
141
+ },
142
+ {
143
+ name: "422 Business",
144
+ err: apierror.Business("plan_limit_exceeded", "Plan limit reached"),
145
+ wantStatus: http.StatusUnprocessableEntity,
146
+ wantErrorCode: "plan_limit_exceeded",
147
+ wantErrorType: apierror.TypeInvalidRequest,
148
+ },
149
+ {
150
+ name: "429 TooManyRequests",
151
+ err: apierror.TooManyRequests(),
152
+ wantStatus: http.StatusTooManyRequests,
153
+ wantErrorCode: apierror.CodeTooManyRequests,
154
+ wantErrorType: apierror.TypeRateLimit,
155
+ },
156
+ {
157
+ name: "500 Internal",
158
+ err: apierror.Internal(),
159
+ wantStatus: http.StatusInternalServerError,
160
+ wantErrorCode: apierror.CodeInternalError,
161
+ wantErrorType: apierror.TypeAPI,
162
+ },
163
+ }
164
+
165
+ for _, tc := range tests {
166
+ t.Run(tc.name, func(t *testing.T) {
167
+ c, w := newTestContext()
168
+ Error(c, tc.err)
169
+
170
+ assert.Equal(t, tc.wantStatus, w.Code, "HTTP 状态码不匹配")
171
+
172
+ var body apierror.ErrorResponse
173
+ err := json.Unmarshal(w.Body.Bytes(), &body)
174
+ require.NoError(t, err, "响应体应为有效 JSON")
175
+ assert.Equal(t, tc.wantErrorCode, body.Error.Code, "错误码不匹配")
176
+ assert.Equal(t, tc.wantErrorType, body.Error.Type, "错误类型不匹配")
177
+ })
178
+ }
179
+ }
180
+
181
+ func TestErrorProjectsValidatedRetryAfterMetadata(t *testing.T) {
182
+ headers := make(http.Header)
183
+ headers.Set("Content-Type", "application/json")
184
+ headers.Set(types.HeaderRetryAfter, "37")
185
+ headers.Set("X-Upstream-Internal", "must-not-leak")
186
+ decoded := apierror.DecodeHTTPResponse(
187
+ http.StatusTooManyRequests,
188
+ headers,
189
+ []byte(`{"error":{"type":"rate_limit_error","code":"rate_limited","message":"Too many requests"}}`),
190
+ nil,
191
+ )
192
+
193
+ c, w := newTestContext()
194
+ Error(c, fmt.Errorf("platform request failed: %w", decoded))
195
+
196
+ assert.Equal(t, http.StatusTooManyRequests, w.Code)
197
+ assert.Equal(t, []string{"37"}, w.Header().Values(types.HeaderRetryAfter))
198
+ assert.Empty(t, w.Header().Get("X-Upstream-Internal"))
199
+ var body apierror.ErrorResponse
200
+ require.NoError(t, json.Unmarshal(w.Body.Bytes(), &body))
201
+ assert.Equal(t, apierror.ErrorDetail{
202
+ Type: "rate_limit_error", Code: "rate_limited", Message: "Too many requests",
203
+ }, body.Error)
204
+ }
205
+
206
+ func TestErrorDoesNotProjectRetryAfterForOtherStatus(t *testing.T) {
207
+ headers := make(http.Header)
208
+ headers.Set("Content-Type", "application/json")
209
+ headers.Set(types.HeaderRetryAfter, "37")
210
+ decoded := apierror.DecodeHTTPResponse(
211
+ http.StatusTooManyRequests,
212
+ headers,
213
+ []byte(`{"error":{"type":"rate_limit_error","code":"rate_limited","message":"Too many requests"}}`),
214
+ nil,
215
+ )
216
+ decoded.Status = http.StatusBadRequest
217
+
218
+ c, w := newTestContext()
219
+ Error(c, decoded)
220
+
221
+ assert.Equal(t, http.StatusBadRequest, w.Code)
222
+ assert.Empty(t, w.Header().Get(types.HeaderRetryAfter))
223
+ }
224
+
225
+ // TestError_UnknownError 验证非 APIError 的普通 error 返回 500
226
+ func TestError_UnknownError(t *testing.T) {
227
+ c, w := newTestContext()
228
+ Error(c, fmt.Errorf("some unexpected database error"))
229
+
230
+ assert.Equal(t, http.StatusInternalServerError, w.Code)
231
+
232
+ var body apierror.ErrorResponse
233
+ err := json.Unmarshal(w.Body.Bytes(), &body)
234
+ require.NoError(t, err)
235
+ assert.Equal(t, apierror.CodeInternalError, body.Error.Code)
236
+ assert.Equal(t, apierror.TypeAPI, body.Error.Type)
237
+ }
238
+
239
+ // TestNewPaginated 验证 TotalPages 向上取整计算和空数据处理
240
+ func TestNewPaginated(t *testing.T) {
241
+ tests := []struct {
242
+ name string
243
+ data []string
244
+ page int
245
+ pageSize int
246
+ total int64
247
+ wantTotalPages int
248
+ wantDataLen int
249
+ }{
250
+ {
251
+ name: "整除情况 10/5=2",
252
+ data: []string{"a", "b", "c", "d", "e"},
253
+ page: 1,
254
+ pageSize: 5,
255
+ total: 10,
256
+ wantTotalPages: 2,
257
+ wantDataLen: 5,
258
+ },
259
+ {
260
+ name: "向上取整 11/5=3",
261
+ data: []string{"a"},
262
+ page: 3,
263
+ pageSize: 5,
264
+ total: 11,
265
+ wantTotalPages: 3,
266
+ wantDataLen: 1,
267
+ },
268
+ {
269
+ name: "向上取整 1/20=1",
270
+ data: []string{"only-one"},
271
+ page: 1,
272
+ pageSize: 20,
273
+ total: 1,
274
+ wantTotalPages: 1,
275
+ wantDataLen: 1,
276
+ },
277
+ {
278
+ name: "total 为 0 时 totalPages 为 0",
279
+ data: []string{},
280
+ page: 1,
281
+ pageSize: 20,
282
+ total: 0,
283
+ wantTotalPages: 0,
284
+ wantDataLen: 0,
285
+ },
286
+ {
287
+ name: "nil data 应被转换为空切片",
288
+ data: nil,
289
+ page: 1,
290
+ pageSize: 20,
291
+ total: 0,
292
+ wantTotalPages: 0,
293
+ wantDataLen: 0,
294
+ },
295
+ {
296
+ name: "100 条数据每页 3 条共 34 页",
297
+ data: make([]string, 3),
298
+ page: 1,
299
+ pageSize: 3,
300
+ total: 100,
301
+ wantTotalPages: 34,
302
+ wantDataLen: 3,
303
+ },
304
+ {
305
+ name: "pageSize 为 0 时 totalPages 为 0",
306
+ data: nil,
307
+ page: 1,
308
+ pageSize: 0,
309
+ total: 50,
310
+ wantTotalPages: 0,
311
+ wantDataLen: 0,
312
+ },
313
+ }
314
+
315
+ for _, tc := range tests {
316
+ t.Run(tc.name, func(t *testing.T) {
317
+ result := NewPaginated(tc.data, tc.page, tc.pageSize, tc.total)
318
+
319
+ assert.Equal(t, tc.wantTotalPages, result.Pagination.TotalPages, "TotalPages 计算错误")
320
+ assert.Equal(t, tc.wantDataLen, len(result.Data), "Data 长度不匹配")
321
+ assert.Equal(t, tc.page, result.Pagination.Page, "Page 不匹配")
322
+ assert.Equal(t, tc.pageSize, result.Pagination.PageSize, "PageSize 不匹配")
323
+ assert.Equal(t, tc.total, result.Pagination.Total, "Total 不匹配")
324
+ assert.NotNil(t, result.Data, "Data 不应为 nil")
325
+ })
326
+ }
327
+ }
328
+
329
+ // TestNewPaginated_JSONSerializable 验证分页响应可以正常序列化为 JSON
330
+ func TestNewPaginated_JSONSerializable(t *testing.T) {
331
+ type Item struct {
332
+ ID int `json:"id"`
333
+ Name string `json:"name"`
334
+ }
335
+
336
+ data := []Item{{ID: 1, Name: "foo"}, {ID: 2, Name: "bar"}}
337
+ result := NewPaginated(data, 1, 10, 2)
338
+
339
+ raw, err := json.Marshal(result)
340
+ require.NoError(t, err)
341
+
342
+ var decoded Paginated[Item]
343
+ err = json.Unmarshal(raw, &decoded)
344
+ require.NoError(t, err)
345
+
346
+ assert.Equal(t, 2, len(decoded.Data))
347
+ assert.Equal(t, 1, decoded.Pagination.TotalPages)
348
+ assert.Equal(t, int64(2), decoded.Pagination.Total)
349
+ }
350
+
351
+ // TestValidationError_NonValidatorError 验证普通 error 走 BadRequest 路径
352
+ func TestValidationError_NonValidatorError(t *testing.T) {
353
+ c, w := newTestContext()
354
+ ValidationError(c, fmt.Errorf("plain error"))
355
+
356
+ assert.Equal(t, http.StatusBadRequest, w.Code)
357
+
358
+ var body apierror.ErrorResponse
359
+ err := json.Unmarshal(w.Body.Bytes(), &body)
360
+ require.NoError(t, err)
361
+ assert.Equal(t, apierror.CodeValidationFailed, body.Error.Code)
362
+ assert.Equal(t, apierror.TypeInvalidRequest, body.Error.Type)
363
+ }
364
+
365
+ // TestValidationError_ValidatorErrors 验证 go-playground/validator 校验错误的格式化
366
+ func TestValidationError_ValidatorErrors(t *testing.T) {
367
+ type SampleDTO struct {
368
+ Name string `json:"name" validate:"required"`
369
+ Email string `json:"email" validate:"required,email"`
370
+ Age int `json:"age" validate:"min=18"`
371
+ }
372
+
373
+ v := validator.New()
374
+ // 注册 JSON tag 名映射,与 response.go 中行为一致
375
+ v.RegisterTagNameFunc(func(fld reflect.StructField) string {
376
+ name := strings.SplitN(fld.Tag.Get("json"), ",", 2)[0]
377
+ if name == "-" {
378
+ return ""
379
+ }
380
+ return name
381
+ })
382
+
383
+ // 空结构体会触发 required 和 min 校验失败
384
+ dto := SampleDTO{Age: 10}
385
+ validationErr := v.Struct(dto)
386
+ require.Error(t, validationErr)
387
+
388
+ c, w := newTestContext()
389
+ ValidationError(c, validationErr)
390
+
391
+ assert.Equal(t, http.StatusBadRequest, w.Code)
392
+
393
+ var body apierror.ErrorResponse
394
+ err := json.Unmarshal(w.Body.Bytes(), &body)
395
+ require.NoError(t, err)
396
+ assert.Equal(t, apierror.CodeValidationFailed, body.Error.Code)
397
+ assert.Equal(t, apierror.TypeValidation, body.Error.Type)
398
+ assert.NotEmpty(t, body.Error.Errors, "应包含字段级错误列表")
399
+ }
400
+
401
+ // TestFormatValidationMessage 通过完整校验流程间接验证 formatValidationMessage 的各个 tag 分支
402
+ func TestFormatValidationMessage_Tags(t *testing.T) {
403
+ type DTO struct {
404
+ Email string `json:"email" validate:"email"`
405
+ MinVal string `json:"min_val" validate:"min=5"`
406
+ MaxVal string `json:"max_val" validate:"max=3"`
407
+ OneOf string `json:"one_of" validate:"oneof=a b c"`
408
+ GteVal int `json:"gte_val" validate:"gte=10"`
409
+ LteVal int `json:"lte_val" validate:"lte=5"`
410
+ GtVal int `json:"gt_val" validate:"gt=0"`
411
+ LtVal int `json:"lt_val" validate:"lt=10"`
412
+ }
413
+
414
+ v := validator.New()
415
+
416
+ // 触发 email 校验失败
417
+ dto := DTO{
418
+ Email: "not-an-email",
419
+ MinVal: "ab", // 长度不足 5
420
+ MaxVal: "toolong", // 长度超过 3
421
+ OneOf: "x", // 不在枚举中
422
+ GteVal: 5, // 小于 10
423
+ LteVal: 10, // 大于 5
424
+ GtVal: 0, // 不大于 0
425
+ LtVal: 10, // 不小于 10
426
+ }
427
+ errs := v.Struct(dto)
428
+ require.Error(t, errs)
429
+
430
+ var ve validator.ValidationErrors
431
+ require.ErrorAs(t, errs, &ve)
432
+
433
+ // 建立 tag -> message 的映射,用于快速断言
434
+ tagMessages := make(map[string]string)
435
+ for _, fe := range ve {
436
+ tagMessages[fe.Tag()] = formatValidationMessage(fe)
437
+ }
438
+
439
+ assert.Equal(t, "must be a valid email", tagMessages["email"])
440
+ assert.Contains(t, tagMessages["min"], "5")
441
+ assert.Contains(t, tagMessages["max"], "3")
442
+ assert.Contains(t, tagMessages["oneof"], "a b c")
443
+ assert.Contains(t, tagMessages["gte"], "10")
444
+ assert.Contains(t, tagMessages["lte"], "5")
445
+ assert.Contains(t, tagMessages["gt"], "0")
446
+ assert.Contains(t, tagMessages["lt"], "10")
447
+ }
448
+
449
+ // TestFormatValidationMessage_DefaultBranch 验证未知 tag 走 default 分支
450
+ func TestFormatValidationMessage_DefaultBranch(t *testing.T) {
451
+ type DTO struct {
452
+ URL string `json:"url" validate:"url"`
453
+ }
454
+ v := validator.New()
455
+ errs := v.Struct(DTO{URL: "not-a-url"})
456
+ require.Error(t, errs)
457
+
458
+ var ve validator.ValidationErrors
459
+ require.ErrorAs(t, errs, &ve)
460
+
461
+ msg := formatValidationMessage(ve[0])
462
+ assert.Equal(t, "must be a valid URL", msg)
463
+ }
@@ -0,0 +1,141 @@
1
+ package ruleexpression
2
+
3
+ // SchemaVersionV1 是 Requirement Expression V1 的唯一受支持版本。
4
+ const SchemaVersionV1 = 1
5
+
6
+ // NodeKind 标识封闭 AST 中的节点类型。
7
+ type NodeKind string
8
+
9
+ const (
10
+ NodeKindAll NodeKind = "all"
11
+ NodeKindAny NodeKind = "any"
12
+ NodeKindNot NodeKind = "not"
13
+ NodeKindPredicate NodeKind = "predicate"
14
+ )
15
+
16
+ // Subject 标识 predicate 读取的通用事实命名空间。
17
+ type Subject string
18
+
19
+ const (
20
+ SubjectProduct Subject = "product"
21
+ SubjectAttribute Subject = "attribute"
22
+ SubjectCapability Subject = "capability"
23
+ SubjectInsightsMetric Subject = "insights_metric"
24
+ SubjectProductDataset Subject = "product_dataset"
25
+ )
26
+
27
+ // Operator 标识 Requirement Expression V1 支持的比较操作。
28
+ type Operator string
29
+
30
+ const (
31
+ OperatorEqual Operator = "eq"
32
+ OperatorNotEqual Operator = "neq"
33
+ OperatorIn Operator = "in"
34
+ OperatorNotIn Operator = "not_in"
35
+ OperatorExists Operator = "exists"
36
+ OperatorActive Operator = "active"
37
+ OperatorInactive Operator = "inactive"
38
+ OperatorAvailable Operator = "available"
39
+ OperatorFreshWithinSeconds Operator = "fresh_within_seconds"
40
+ )
41
+
42
+ // ExpressionV1 是带版本信封的 Requirement Expression V1。
43
+ type ExpressionV1 struct {
44
+ // SchemaVersion 固定为 SchemaVersionV1。
45
+ SchemaVersion int `json:"schema_version"`
46
+ // Root 是表达式的根节点。
47
+ Root Node `json:"root"`
48
+ }
49
+
50
+ // Node 封闭 AST 节点集合,外部包不能扩展节点类型。
51
+ type Node interface {
52
+ Kind() NodeKind
53
+ isRequirementNode()
54
+ }
55
+
56
+ // AllNode 表示全部子节点都通过的组合条件。
57
+ type AllNode struct {
58
+ // Children 按声明顺序参与确定性求值。
59
+ Children []Node `json:"children"`
60
+ }
61
+
62
+ // Kind 返回 all 节点类型。
63
+ func (*AllNode) Kind() NodeKind { return NodeKindAll }
64
+
65
+ func (*AllNode) isRequirementNode() {}
66
+
67
+ // AnyNode 表示至少一个子节点通过的组合条件。
68
+ type AnyNode struct {
69
+ // Children 按声明顺序参与确定性求值。
70
+ Children []Node `json:"children"`
71
+ }
72
+
73
+ // Kind 返回 any 节点类型。
74
+ func (*AnyNode) Kind() NodeKind { return NodeKindAny }
75
+
76
+ func (*AnyNode) isRequirementNode() {}
77
+
78
+ // NotNode 表示对子节点执行三值逻辑取反。
79
+ type NotNode struct {
80
+ // Child 是唯一子节点。
81
+ Child Node `json:"child"`
82
+ }
83
+
84
+ // Kind 返回 not 节点类型。
85
+ func (*NotNode) Kind() NodeKind { return NodeKindNot }
86
+
87
+ func (*NotNode) isRequirementNode() {}
88
+
89
+ // PredicateNode 表示由消费方解析的叶子条件。
90
+ type PredicateNode struct {
91
+ // Subject 标识事实命名空间。
92
+ Subject Subject `json:"subject"`
93
+ // Key 标识命名空间内的事实键。
94
+ Key string `json:"key"`
95
+ // Operator 标识比较语义。
96
+ Operator Operator `json:"operator"`
97
+ // Value 是操作符需要的可选类型化值。
98
+ Value Value `json:"value,omitempty"`
99
+ }
100
+
101
+ // Kind 返回 predicate 节点类型。
102
+ func (*PredicateNode) Kind() NodeKind { return NodeKindPredicate }
103
+
104
+ func (*PredicateNode) isRequirementNode() {}
105
+
106
+ // Value 封闭 predicate 值集合,外部包不能扩展值类型。
107
+ type Value interface {
108
+ isRequirementValue()
109
+ }
110
+
111
+ // BooleanValue 保存布尔 predicate 值。
112
+ type BooleanValue struct {
113
+ // Value 是布尔值本身。
114
+ Value bool
115
+ }
116
+
117
+ func (*BooleanValue) isRequirementValue() {}
118
+
119
+ // NumberValue 保存 IEEE 754 双精度 predicate 值。
120
+ type NumberValue struct {
121
+ // Value 是数值本身。
122
+ Value float64
123
+ }
124
+
125
+ func (*NumberValue) isRequirementValue() {}
126
+
127
+ // StringValue 保存字符串 predicate 值。
128
+ type StringValue struct {
129
+ // Value 是字符串本身。
130
+ Value string
131
+ }
132
+
133
+ func (*StringValue) isRequirementValue() {}
134
+
135
+ // StringArrayValue 保存有序字符串数组 predicate 值。
136
+ type StringArrayValue struct {
137
+ // Values 保留输入顺序,canonical encoding 不重排数组。
138
+ Values []string
139
+ }
140
+
141
+ func (*StringArrayValue) isRequirementValue() {}
@@ -0,0 +1,81 @@
1
+ package ruleexpression
2
+
3
+ import (
4
+ "bytes"
5
+ "encoding/json"
6
+ "errors"
7
+ "testing"
8
+ )
9
+
10
+ func TestNodeKinds(t *testing.T) {
11
+ t.Parallel()
12
+
13
+ tests := []struct {
14
+ node Node
15
+ want NodeKind
16
+ }{
17
+ {node: &AllNode{Children: []Node{resultPredicate("all")}}, want: NodeKindAll},
18
+ {node: &AnyNode{Children: []Node{resultPredicate("any")}}, want: NodeKindAny},
19
+ {node: &NotNode{Child: resultPredicate("not")}, want: NodeKindNot},
20
+ {node: resultPredicate("predicate"), want: NodeKindPredicate},
21
+ }
22
+ for _, test := range tests {
23
+ if got := test.node.Kind(); got != test.want {
24
+ t.Fatalf("Kind() = %s, want %s", got, test.want)
25
+ }
26
+ }
27
+ }
28
+
29
+ func TestExpressionV1JSONRoundTripUsesCanonicalContract(t *testing.T) {
30
+ t.Parallel()
31
+
32
+ raw := []byte(`{"root":{"operator":"eq","value":["east","west"],"key":"regions","subject":"attribute","kind":"predicate"},"schema_version":1}`)
33
+ var expression ExpressionV1
34
+ if err := json.Unmarshal(raw, &expression); err != nil {
35
+ t.Fatalf("json.Unmarshal() error = %v", err)
36
+ }
37
+ encoded, err := json.Marshal(expression)
38
+ if err != nil {
39
+ t.Fatalf("json.Marshal() error = %v", err)
40
+ }
41
+ want := []byte(`{"root":{"key":"regions","kind":"predicate","operator":"eq","subject":"attribute","value":["east","west"]},"schema_version":1}`)
42
+ if !bytes.Equal(encoded, want) {
43
+ t.Fatalf("json.Marshal() = %s, want %s", encoded, want)
44
+ }
45
+ }
46
+
47
+ func TestProgrammaticASTRejectsUnsupportedVersionAndTypedNilNodes(t *testing.T) {
48
+ t.Parallel()
49
+
50
+ invalidVersion := expressionWithRoot(resultPredicate("version"))
51
+ invalidVersion.SchemaVersion = SchemaVersionV1 + 1
52
+ _, err := CanonicalJSON(invalidVersion)
53
+ assertErrorCode(t, err, ErrorCodeUnsupportedSchemaVersion)
54
+
55
+ var all *AllNode
56
+ var anyNode *AnyNode
57
+ var not *NotNode
58
+ var predicate *PredicateNode
59
+ for _, node := range []Node{all, anyNode, not, predicate} {
60
+ _, err = CanonicalJSON(expressionWithRoot(node))
61
+ assertErrorCode(t, err, ErrorCodeInvalidNode)
62
+ }
63
+ }
64
+
65
+ func TestErrorFormattingAndUnwrap(t *testing.T) {
66
+ t.Parallel()
67
+
68
+ withoutPath := newError(ErrorCodeInvalidJSON, "", "JSON is malformed")
69
+ if got := withoutPath.Error(); got != "invalid_json: JSON is malformed" {
70
+ t.Fatalf("Error() = %q", got)
71
+ }
72
+
73
+ cause := errors.New("unexpected token")
74
+ withPath := wrapError(ErrorCodeInvalidJSON, "$.root", "JSON is malformed", cause)
75
+ if got := withPath.Error(); got != "invalid_json at $.root: JSON is malformed: unexpected token" {
76
+ t.Fatalf("Error() = %q", got)
77
+ }
78
+ if !errors.Is(withPath, cause) {
79
+ t.Fatalf("errors.Is() = false, want true")
80
+ }
81
+ }