@stackonward/cli 0.0.1 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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 +16 -12
@@ -0,0 +1,100 @@
1
+ package jsonschema
2
+
3
+ import (
4
+ "bytes"
5
+ "crypto/sha256"
6
+ "encoding/hex"
7
+ "encoding/json"
8
+ "fmt"
9
+ "strings"
10
+ "sync"
11
+
12
+ schema "github.com/santhosh-tekuri/jsonschema/v6"
13
+ )
14
+
15
+ // CompileStage 标识 JSON Schema 编译失败的确定阶段。
16
+ type CompileStage string
17
+
18
+ const (
19
+ CompileStageDecode CompileStage = "decode"
20
+ CompileStageResource CompileStage = "resource"
21
+ CompileStageSchema CompileStage = "schema"
22
+ )
23
+
24
+ // CompileError 保留编译阶段,让业务适配器维持各自既有错误合同。
25
+ type CompileError struct {
26
+ Stage CompileStage
27
+ Err error
28
+ }
29
+
30
+ func (e *CompileError) Error() string {
31
+ if e == nil || e.Err == nil {
32
+ return "JSON Schema compilation failed"
33
+ }
34
+ return e.Err.Error()
35
+ }
36
+
37
+ func (e *CompileError) Unwrap() error {
38
+ if e == nil {
39
+ return nil
40
+ }
41
+ return e.Err
42
+ }
43
+
44
+ // CompilerOptions 定义资源 URL 和外部引用策略。
45
+ type CompilerOptions struct {
46
+ ResourceURL func(schemaHash string) string
47
+ RejectExternalReferences bool
48
+ }
49
+
50
+ // Compiler 提供并发安全的不可变 JSON Schema 编译缓存。
51
+ type Compiler struct {
52
+ cache sync.Map
53
+ options CompilerOptions
54
+ }
55
+
56
+ // NewCompiler 创建 JSON Schema 编译器。
57
+ func NewCompiler(options CompilerOptions) *Compiler {
58
+ return &Compiler{options: options}
59
+ }
60
+
61
+ // Compile 解码、注册并编译 schema;相同原始 schema 在实例内精确复用。
62
+ func (c *Compiler) Compile(schemaRaw json.RawMessage) (*schema.Schema, error) {
63
+ if c == nil || c.options.ResourceURL == nil {
64
+ return nil, &CompileError{Stage: CompileStageResource, Err: fmt.Errorf("schema resource URL factory is required")}
65
+ }
66
+ digest := sha256.Sum256(schemaRaw)
67
+ cacheKey := hex.EncodeToString(digest[:])
68
+ if cached, ok := c.cache.Load(cacheKey); ok {
69
+ return cached.(*schema.Schema), nil
70
+ }
71
+
72
+ document, err := schema.UnmarshalJSON(bytes.NewReader(schemaRaw))
73
+ if err != nil {
74
+ return nil, &CompileError{Stage: CompileStageDecode, Err: err}
75
+ }
76
+ compiler := schema.NewCompiler()
77
+ if c.options.RejectExternalReferences {
78
+ compiler.UseLoader(rejectingLoader{})
79
+ }
80
+ resourceURL := strings.TrimSpace(c.options.ResourceURL(cacheKey))
81
+ if resourceURL == "" {
82
+ return nil, &CompileError{Stage: CompileStageResource, Err: fmt.Errorf("schema resource URL is required")}
83
+ }
84
+ if err := compiler.AddResource(resourceURL, document); err != nil {
85
+ return nil, &CompileError{Stage: CompileStageResource, Err: err}
86
+ }
87
+ compiled, err := compiler.Compile(resourceURL)
88
+ if err != nil {
89
+ return nil, &CompileError{Stage: CompileStageSchema, Err: err}
90
+ }
91
+ actual, _ := c.cache.LoadOrStore(cacheKey, compiled)
92
+ return actual.(*schema.Schema), nil
93
+ }
94
+
95
+ type rejectingLoader struct{}
96
+
97
+ // Load 阻止 schema 触发网络或本地文件读取。
98
+ func (rejectingLoader) Load(url string) (any, error) { //nolint:T1 // any 来自第三方 JSON Schema loader 契约。
99
+ return nil, fmt.Errorf("external schema reference is not allowed: %s", url)
100
+ }
@@ -0,0 +1,41 @@
1
+ package jsonschema
2
+
3
+ import (
4
+ "encoding/json"
5
+ "errors"
6
+ "testing"
7
+ )
8
+
9
+ func TestCompilerCachesSchemaAndRejectsExternalReferences(t *testing.T) {
10
+ compiler := NewCompiler(CompilerOptions{
11
+ ResourceURL: func(hash string) string { return "test-schema://" + hash + ".json" },
12
+ RejectExternalReferences: true,
13
+ })
14
+ raw := json.RawMessage(`{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":false}`)
15
+ first, err := compiler.Compile(raw)
16
+ if err != nil {
17
+ t.Fatalf("Compile() error = %v", err)
18
+ }
19
+ second, err := compiler.Compile(raw)
20
+ if err != nil {
21
+ t.Fatalf("Compile(replay) error = %v", err)
22
+ }
23
+ if first != second {
24
+ t.Fatal("Compile() did not reuse cached schema")
25
+ }
26
+
27
+ _, err = compiler.Compile(json.RawMessage(`{"$ref":"https://example.com/schema.json"}`))
28
+ var compileErr *CompileError
29
+ if !errors.As(err, &compileErr) || compileErr.Stage != CompileStageSchema {
30
+ t.Fatalf("Compile(external ref) error = %v", err)
31
+ }
32
+ }
33
+
34
+ func TestCompilerClassifiesInvalidJSON(t *testing.T) {
35
+ compiler := NewCompiler(CompilerOptions{ResourceURL: func(string) string { return "test-schema://schema.json" }})
36
+ _, err := compiler.Compile(json.RawMessage(`{"type":`))
37
+ var compileErr *CompileError
38
+ if !errors.As(err, &compileErr) || compileErr.Stage != CompileStageDecode {
39
+ t.Fatalf("Compile(invalid JSON) error = %v", err)
40
+ }
41
+ }
@@ -0,0 +1,83 @@
1
+ package jwksapi
2
+
3
+ import (
4
+ "crypto/sha256"
5
+ "encoding/hex"
6
+ "encoding/json"
7
+ "fmt"
8
+ "net/http"
9
+
10
+ "github.com/gin-gonic/gin"
11
+
12
+ "{{module}}/internal/core/config"
13
+ "{{module}}/internal/core/jwtkeyring"
14
+ )
15
+
16
+ // Handler 发布 Identity 与 IAM 签名域的统一 RFC 7517 公钥集。
17
+ type Handler struct {
18
+ registry *jwtkeyring.Registry
19
+ keySetSHA256 string
20
+ }
21
+
22
+ // KeySetDigestProvider 提供当前统一公钥集的稳定内容摘要。
23
+ type KeySetDigestProvider interface {
24
+ KeySetSHA256() (string, error)
25
+ }
26
+
27
+ var _ KeySetDigestProvider = (*Handler)(nil)
28
+
29
+ // NewHandler 装载公开密钥并构建 kid 全局唯一的 JWKS 注册表。
30
+ func NewHandler(cfg *config.Config) (*Handler, error) {
31
+ if cfg == nil {
32
+ return nil, fmt.Errorf("JWKS configuration is required")
33
+ }
34
+ identityRing, err := jwtkeyring.Load(jwtkeyring.Config{
35
+ ActiveKeyID: cfg.Identity.AccessToken.SigningKeyID,
36
+ PublicKeyDirectory: cfg.Identity.AccessToken.PublicKeyDirectory,
37
+ })
38
+ if err != nil {
39
+ return nil, fmt.Errorf("load identity JWKS key ring: %w", err)
40
+ }
41
+ iamRing, err := jwtkeyring.Load(jwtkeyring.Config{
42
+ ActiveKeyID: cfg.InternalService.ServiceTokenSigning.KeyID,
43
+ PublicKeyDirectory: cfg.InternalService.ServiceTokenSigning.PublicKeyDirectory,
44
+ })
45
+ if err != nil {
46
+ return nil, fmt.Errorf("load IAM JWKS key ring: %w", err)
47
+ }
48
+ registry := jwtkeyring.NewRegistry()
49
+ if err := registry.Register("identity-access-token", identityRing); err != nil {
50
+ return nil, err
51
+ }
52
+ if err := registry.Register("iam-service-token", iamRing); err != nil {
53
+ return nil, err
54
+ }
55
+ canonicalKeySet, err := json.Marshal(registry.JSONWebKeySet())
56
+ if err != nil {
57
+ return nil, fmt.Errorf("marshal canonical JWKS: %w", err)
58
+ }
59
+ digest := sha256.Sum256(canonicalKeySet)
60
+ return &Handler{
61
+ registry: registry,
62
+ keySetSHA256: hex.EncodeToString(digest[:]),
63
+ }, nil
64
+ }
65
+
66
+ // RegisterRoutes 注册统一公钥端点。
67
+ func (h *Handler) RegisterRoutes(root *gin.RouterGroup) {
68
+ root.GET("/.well-known/jwks.json", h.Get)
69
+ }
70
+
71
+ // Get 返回可缓存的统一 JWKS。
72
+ func (h *Handler) Get(c *gin.Context) {
73
+ c.Header("Cache-Control", "public, max-age=300, stale-while-revalidate=300")
74
+ c.JSON(http.StatusOK, h.registry.JSONWebKeySet())
75
+ }
76
+
77
+ // KeySetSHA256 返回稳定排序后统一 JWKS 规范 JSON 的 SHA-256 摘要。
78
+ func (h *Handler) KeySetSHA256() (string, error) {
79
+ if h == nil || h.keySetSHA256 == "" {
80
+ return "", fmt.Errorf("JWKS key set digest is unavailable")
81
+ }
82
+ return h.keySetSHA256, nil
83
+ }
@@ -0,0 +1,104 @@
1
+ package jwksapi
2
+
3
+ import (
4
+ "crypto/rand"
5
+ "crypto/rsa"
6
+ "crypto/sha256"
7
+ "crypto/x509"
8
+ "encoding/hex"
9
+ "encoding/json"
10
+ "encoding/pem"
11
+ "net/http"
12
+ "net/http/httptest"
13
+ "os"
14
+ "path/filepath"
15
+ "testing"
16
+
17
+ "github.com/gin-gonic/gin"
18
+ "github.com/stretchr/testify/require"
19
+
20
+ "{{module}}/internal/core/config"
21
+ "{{module}}/internal/core/jwtkeyring"
22
+ )
23
+
24
+ func TestHandlerPublishesStableUnifiedJWKS(t *testing.T) {
25
+ gin.SetMode(gin.TestMode)
26
+ identityDirectory := t.TempDir()
27
+ iamDirectory := t.TempDir()
28
+ writeJWKSPublicKey(t, identityDirectory, "z-identity", generateJWKSKey(t))
29
+ writeJWKSPublicKey(t, iamDirectory, "a-iam", generateJWKSKey(t))
30
+ handler, err := NewHandler(&config.Config{
31
+ Identity: config.IdentityConfig{AccessToken: config.IdentityAccessTokenConfig{
32
+ SigningKeyID: "z-identity", PublicKeyDirectory: identityDirectory,
33
+ }},
34
+ InternalService: config.InternalServiceConfig{ServiceTokenSigning: config.ServiceTokenSigningConfig{
35
+ KeyID: "a-iam", PublicKeyDirectory: iamDirectory,
36
+ }},
37
+ })
38
+ require.NoError(t, err)
39
+
40
+ recorder := httptest.NewRecorder()
41
+ context, _ := gin.CreateTestContext(recorder)
42
+ context.Request = httptest.NewRequest(http.MethodGet, "/.well-known/jwks.json", nil)
43
+ handler.Get(context)
44
+
45
+ require.Equal(t, http.StatusOK, recorder.Code)
46
+ require.Equal(t, "public, max-age=300, stale-while-revalidate=300", recorder.Header().Get("Cache-Control"))
47
+ var result jwtkeyring.JSONWebKeySet
48
+ require.NoError(t, json.Unmarshal(recorder.Body.Bytes(), &result))
49
+ require.Len(t, result.Keys, 2)
50
+ require.Equal(t, "a-iam", result.Keys[0].KeyID)
51
+ require.Equal(t, "z-identity", result.Keys[1].KeyID)
52
+ for _, key := range result.Keys {
53
+ require.Equal(t, "RSA", key.KeyType)
54
+ require.Equal(t, "RS256", key.Algorithm)
55
+ require.NotEmpty(t, key.Modulus)
56
+ require.NotEmpty(t, key.Exponent)
57
+ }
58
+ canonicalKeySet, err := json.Marshal(result)
59
+ require.NoError(t, err)
60
+ wantDigest := sha256.Sum256(canonicalKeySet)
61
+ gotDigest, err := handler.KeySetSHA256()
62
+ require.NoError(t, err)
63
+ require.Equal(t, hex.EncodeToString(wantDigest[:]), gotDigest)
64
+ require.Regexp(t, "^[0-9a-f]{64}$", gotDigest)
65
+ }
66
+
67
+ func TestNewHandlerRejectsKeyIDCollisionAcrossSigningDomains(t *testing.T) {
68
+ identityDirectory := t.TempDir()
69
+ iamDirectory := t.TempDir()
70
+ key := generateJWKSKey(t)
71
+ writeJWKSPublicKey(t, identityDirectory, "shared-key", key)
72
+ writeJWKSPublicKey(t, iamDirectory, "shared-key", key)
73
+
74
+ _, err := NewHandler(&config.Config{
75
+ Identity: config.IdentityConfig{AccessToken: config.IdentityAccessTokenConfig{
76
+ SigningKeyID: "shared-key", PublicKeyDirectory: identityDirectory,
77
+ }},
78
+ InternalService: config.InternalServiceConfig{ServiceTokenSigning: config.ServiceTokenSigningConfig{
79
+ KeyID: "shared-key", PublicKeyDirectory: iamDirectory,
80
+ }},
81
+ })
82
+ require.ErrorContains(t, err, "duplicated across signing domains")
83
+ }
84
+
85
+ func TestNilHandlerRejectsKeySetDigestRead(t *testing.T) {
86
+ var handler *Handler
87
+ _, err := handler.KeySetSHA256()
88
+ require.ErrorContains(t, err, "digest is unavailable")
89
+ }
90
+
91
+ func generateJWKSKey(t *testing.T) *rsa.PublicKey {
92
+ t.Helper()
93
+ key, err := rsa.GenerateKey(rand.Reader, 2048)
94
+ require.NoError(t, err)
95
+ return &key.PublicKey
96
+ }
97
+
98
+ func writeJWKSPublicKey(t *testing.T, directory, keyID string, key *rsa.PublicKey) {
99
+ t.Helper()
100
+ der, err := x509.MarshalPKIXPublicKey(key)
101
+ require.NoError(t, err)
102
+ encoded := pem.EncodeToMemory(&pem.Block{Type: "PUBLIC KEY", Bytes: der})
103
+ require.NoError(t, os.WriteFile(filepath.Join(directory, keyID+".pem"), encoded, 0o600))
104
+ }
@@ -0,0 +1,145 @@
1
+ package locale
2
+
3
+ import (
4
+ "encoding/json"
5
+ "strings"
6
+ )
7
+
8
+ const (
9
+ DefaultCode = "en"
10
+ AdminDefaultCode = "cn"
11
+ )
12
+
13
+ var supportedCodes = []string{
14
+ "en",
15
+ "cn",
16
+ "tw",
17
+ "de",
18
+ "es",
19
+ "fr",
20
+ "it",
21
+ "ja",
22
+ "ko",
23
+ "pt",
24
+ "hi",
25
+ "ar",
26
+ }
27
+
28
+ var supportedCodeSet = buildSupportedCodeSet()
29
+
30
+ func buildSupportedCodeSet() map[string]struct{} {
31
+ result := make(map[string]struct{}, len(supportedCodes))
32
+ for _, code := range supportedCodes {
33
+ result[code] = struct{}{}
34
+ }
35
+ return result
36
+ }
37
+
38
+ func SupportedCodes() []string {
39
+ result := make([]string, len(supportedCodes))
40
+ copy(result, supportedCodes)
41
+ return result
42
+ }
43
+
44
+ func NormalizeCode(value string) string {
45
+ code := strings.ToLower(strings.TrimSpace(strings.ReplaceAll(value, "_", "-")))
46
+ switch code {
47
+ case "en", "en-us", "en-gb":
48
+ return "en"
49
+ case "cn", "zh", "zh-cn", "zh-hans", "zh-hans-cn":
50
+ return "cn"
51
+ case "tw", "hk", "zh-tw", "zh-hk", "zh-hant", "zh-hant-tw", "zh-hant-hk":
52
+ return "tw"
53
+ case "ja", "jp", "ja-jp":
54
+ return "ja"
55
+ case "ko", "ko-kr":
56
+ return "ko"
57
+ case "de", "de-de":
58
+ return "de"
59
+ case "es", "es-es":
60
+ return "es"
61
+ case "fr", "fr-fr":
62
+ return "fr"
63
+ case "it", "it-it":
64
+ return "it"
65
+ case "pt", "pt-br", "pt-pt":
66
+ return "pt"
67
+ case "hi", "in", "hi-in":
68
+ return "hi"
69
+ case "ar", "ar-sa":
70
+ return "ar"
71
+ }
72
+ return ""
73
+ }
74
+
75
+ func NormalizeCodeOrDefault(value string, fallback string) string {
76
+ if code := NormalizeCode(value); code != "" {
77
+ return code
78
+ }
79
+ if code := NormalizeCode(fallback); code != "" {
80
+ return code
81
+ }
82
+ return DefaultCode
83
+ }
84
+
85
+ func IsShortCode(value string) bool {
86
+ code := strings.TrimSpace(value)
87
+ if code == "" || code != strings.ToLower(code) {
88
+ return false
89
+ }
90
+ _, ok := supportedCodeSet[code]
91
+ return ok
92
+ }
93
+
94
+ func NormalizeTextMap(input map[string]string) map[string]string {
95
+ if len(input) == 0 {
96
+ return map[string]string{}
97
+ }
98
+ result := make(map[string]string, len(input))
99
+ for key, value := range input {
100
+ code := NormalizeCode(key)
101
+ text := strings.TrimSpace(value)
102
+ if code == "" || text == "" {
103
+ continue
104
+ }
105
+ if _, exists := result[code]; exists {
106
+ continue
107
+ }
108
+ result[code] = text
109
+ }
110
+ return result
111
+ }
112
+
113
+ func NormalizeLocaleRootedMap[T any](input map[string]T) map[string]T {
114
+ if len(input) == 0 {
115
+ return map[string]T{}
116
+ }
117
+ result := make(map[string]T, len(input))
118
+ for key, value := range input {
119
+ code := NormalizeCode(key)
120
+ if code == "" {
121
+ continue
122
+ }
123
+ if _, exists := result[code]; exists {
124
+ continue
125
+ }
126
+ result[code] = value
127
+ }
128
+ return result
129
+ }
130
+
131
+ func NormalizeRawTextMap(raw json.RawMessage) (json.RawMessage, error) {
132
+ if len(raw) == 0 {
133
+ return json.RawMessage(`{}`), nil
134
+ }
135
+ var input map[string]string
136
+ if err := json.Unmarshal(raw, &input); err != nil {
137
+ return nil, err
138
+ }
139
+ normalized := NormalizeTextMap(input)
140
+ payload, err := json.Marshal(normalized)
141
+ if err != nil {
142
+ return nil, err
143
+ }
144
+ return payload, nil
145
+ }
@@ -0,0 +1,75 @@
1
+ package locale
2
+
3
+ import (
4
+ "encoding/json"
5
+ "reflect"
6
+ "testing"
7
+ )
8
+
9
+ func TestNormalizeCode(t *testing.T) {
10
+ cases := map[string]string{
11
+ "en-US": "en",
12
+ "zh-CN": "cn",
13
+ "zh-TW": "tw",
14
+ "zh-HK": "tw",
15
+ "ja-JP": "ja",
16
+ "jp": "ja",
17
+ "hi-IN": "hi",
18
+ "in": "hi",
19
+ "de": "de",
20
+ "id-ID": "",
21
+ "bad-x": "",
22
+ }
23
+ for input, want := range cases {
24
+ if got := NormalizeCode(input); got != want {
25
+ t.Fatalf("NormalizeCode(%q) = %q, want %q", input, got, want)
26
+ }
27
+ }
28
+ }
29
+
30
+ func TestNormalizeTextMap(t *testing.T) {
31
+ got := NormalizeTextMap(map[string]string{
32
+ "en-US": "English",
33
+ "zh-CN": "中文",
34
+ "ja-JP": "日本語",
35
+ "hi-IN": "हिंदी",
36
+ "bad-x": "ignored",
37
+ })
38
+ want := map[string]string{
39
+ "en": "English",
40
+ "cn": "中文",
41
+ "ja": "日本語",
42
+ "hi": "हिंदी",
43
+ }
44
+ if !reflect.DeepEqual(got, want) {
45
+ t.Fatalf("NormalizeTextMap() = %v, want %v", got, want)
46
+ }
47
+ }
48
+
49
+ func TestIsShortCode(t *testing.T) {
50
+ if !IsShortCode("cn") {
51
+ t.Fatal("IsShortCode(cn) = false, want true")
52
+ }
53
+ if IsShortCode("zh-CN") {
54
+ t.Fatal("IsShortCode(zh-CN) = true, want false")
55
+ }
56
+ if IsShortCode("jp") {
57
+ t.Fatal("IsShortCode(jp) = true, want false")
58
+ }
59
+ if IsShortCode("zz") {
60
+ t.Fatal("IsShortCode(zz) = true, want false")
61
+ }
62
+ }
63
+
64
+ func TestNormalizeLocaleRootedMap(t *testing.T) {
65
+ got := NormalizeLocaleRootedMap(map[string]json.RawMessage{
66
+ "en-US": json.RawMessage(`{"email":{}}`),
67
+ "zh-CN": json.RawMessage(`{"sms":{}}`),
68
+ })
69
+ if _, ok := got["en"]; !ok {
70
+ t.Fatalf("normalized map missing en: %v", got)
71
+ }
72
+ if _, ok := got["cn"]; !ok {
73
+ t.Fatalf("normalized map missing cn: %v", got)
74
+ }
75
+ }
@@ -0,0 +1,54 @@
1
+ package mediaref
2
+
3
+ import "strings"
4
+
5
+ // NormalizeURL 去除媒体 URL 边界空白。
6
+ func NormalizeURL(value string) string {
7
+ return strings.TrimSpace(value)
8
+ }
9
+
10
+ // NormalizeOptionalURL 去除可选媒体 URL 边界空白,空值归一为 nil。
11
+ func NormalizeOptionalURL(value *string) *string {
12
+ if value == nil {
13
+ return nil
14
+ }
15
+ trimmed := strings.TrimSpace(*value)
16
+ if trimmed == "" {
17
+ return nil
18
+ }
19
+ return &trimmed
20
+ }
21
+
22
+ // ApplyOptionalURLAsset 统一应用指针 URL 字段和资产引用字段。
23
+ func ApplyOptionalURLAsset(currentURL **string, currentAssetID **int64, nextURL *string, nextAssetID *int64) {
24
+ if nextURL != nil {
25
+ normalizedURL := NormalizeOptionalURL(nextURL)
26
+ *currentURL = normalizedURL
27
+ if normalizedURL == nil || nextAssetID == nil {
28
+ *currentAssetID = nil
29
+ }
30
+ }
31
+ if nextAssetID != nil {
32
+ *currentAssetID = nextAssetID
33
+ if nextURL == nil {
34
+ *currentURL = nil
35
+ }
36
+ }
37
+ }
38
+
39
+ // ApplyStringURLAsset 统一应用字符串 URL 字段和资产引用字段。
40
+ func ApplyStringURLAsset(currentURL *string, currentAssetID **int64, nextURL *string, nextAssetID *int64) {
41
+ if nextURL != nil {
42
+ normalizedURL := NormalizeURL(*nextURL)
43
+ *currentURL = normalizedURL
44
+ if normalizedURL == "" || nextAssetID == nil {
45
+ *currentAssetID = nil
46
+ }
47
+ }
48
+ if nextAssetID != nil {
49
+ *currentAssetID = nextAssetID
50
+ if nextURL == nil {
51
+ *currentURL = ""
52
+ }
53
+ }
54
+ }
@@ -0,0 +1,77 @@
1
+ package mediaref
2
+
3
+ import "testing"
4
+
5
+ func TestApplyOptionalURLAssetStoresCacheWithAsset(t *testing.T) {
6
+ t.Parallel()
7
+
8
+ var currentURL *string
9
+ var currentAssetID *int64
10
+ nextURL := " https://cdn.example.com/cover.webp "
11
+ nextAssetID := int64(11)
12
+
13
+ ApplyOptionalURLAsset(&currentURL, &currentAssetID, &nextURL, &nextAssetID)
14
+
15
+ if currentURL == nil || *currentURL != "https://cdn.example.com/cover.webp" {
16
+ t.Fatalf("expected trimmed URL cache, got %v", currentURL)
17
+ }
18
+ if currentAssetID == nil || *currentAssetID != nextAssetID {
19
+ t.Fatalf("expected asset id %d, got %v", nextAssetID, currentAssetID)
20
+ }
21
+ }
22
+
23
+ func TestApplyOptionalURLAssetClearsStaleAssetForURLOnly(t *testing.T) {
24
+ t.Parallel()
25
+
26
+ currentURLValue := "https://cdn.example.com/old.webp"
27
+ currentURL := &currentURLValue
28
+ currentAssetIDValue := int64(10)
29
+ currentAssetID := &currentAssetIDValue
30
+ nextURL := "https://external.example.com/new.webp"
31
+
32
+ ApplyOptionalURLAsset(&currentURL, &currentAssetID, &nextURL, nil)
33
+
34
+ if currentURL == nil || *currentURL != nextURL {
35
+ t.Fatalf("expected URL-only cache, got %v", currentURL)
36
+ }
37
+ if currentAssetID != nil {
38
+ t.Fatalf("expected stale asset id to be cleared, got %v", *currentAssetID)
39
+ }
40
+ }
41
+
42
+ func TestApplyOptionalURLAssetClearsStaleURLForAssetOnly(t *testing.T) {
43
+ t.Parallel()
44
+
45
+ currentURLValue := "https://cdn.example.com/old.webp"
46
+ currentURL := &currentURLValue
47
+ currentAssetIDValue := int64(10)
48
+ currentAssetID := &currentAssetIDValue
49
+ nextAssetID := int64(12)
50
+
51
+ ApplyOptionalURLAsset(&currentURL, &currentAssetID, nil, &nextAssetID)
52
+
53
+ if currentURL != nil {
54
+ t.Fatalf("expected stale URL cache to be cleared, got %v", *currentURL)
55
+ }
56
+ if currentAssetID == nil || *currentAssetID != nextAssetID {
57
+ t.Fatalf("expected asset id %d, got %v", nextAssetID, currentAssetID)
58
+ }
59
+ }
60
+
61
+ func TestApplyStringURLAssetClearsStaleURLForAssetOnly(t *testing.T) {
62
+ t.Parallel()
63
+
64
+ currentURL := "https://cdn.example.com/old.webp"
65
+ currentAssetIDValue := int64(10)
66
+ currentAssetID := &currentAssetIDValue
67
+ nextAssetID := int64(12)
68
+
69
+ ApplyStringURLAsset(&currentURL, &currentAssetID, nil, &nextAssetID)
70
+
71
+ if currentURL != "" {
72
+ t.Fatalf("expected stale URL cache to be cleared, got %q", currentURL)
73
+ }
74
+ if currentAssetID == nil || *currentAssetID != nextAssetID {
75
+ t.Fatalf("expected asset id %d, got %v", nextAssetID, currentAssetID)
76
+ }
77
+ }