@salesforce/templates 66.13.4 → 66.13.6

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 (236) hide show
  1. package/lib/generators/baseGenerator.d.ts +2 -0
  2. package/lib/generators/baseGenerator.js +353 -0
  3. package/lib/generators/baseGenerator.js.map +1 -1
  4. package/lib/index.d.ts +1 -0
  5. package/lib/index.js +3 -1
  6. package/lib/index.js.map +1 -1
  7. package/lib/templates/project/angularextapp/CHANGELOG.md +258 -0
  8. package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/angular.json +1 -1
  9. package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/eslint-plugin-angular-graphql.js +148 -0
  10. package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/eslint.config.js +9 -1
  11. package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/package-lock.json +421 -394
  12. package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/package.json +2 -2
  13. package/lib/templates/project/angularextapp/package.json +1 -1
  14. package/lib/templates/project/angularextapp/scripts/org-setup-config-schema.mjs +17 -0
  15. package/lib/templates/project/angularextapp/scripts/org-setup-utils.mjs +33 -3
  16. package/lib/templates/project/angularextapp/scripts/org-setup.mjs +535 -3
  17. package/lib/templates/project/angularintapp/CHANGELOG.md +266 -0
  18. package/lib/templates/project/angularintapp/_p_/_m_/_w_/_a_/angular.json +1 -1
  19. package/lib/templates/project/angularintapp/_p_/_m_/_w_/_a_/eslint-plugin-angular-graphql.js +148 -0
  20. package/lib/templates/project/angularintapp/_p_/_m_/_w_/_a_/eslint.config.js +9 -1
  21. package/lib/templates/project/angularintapp/_p_/_m_/_w_/_a_/package-lock.json +431 -404
  22. package/lib/templates/project/angularintapp/_p_/_m_/_w_/_a_/package.json +2 -2
  23. package/lib/templates/project/angularintapp/_p_/_m_/_w_/_a_/src/app/features/agentforce/agentforce-embed.service.ts +6 -1
  24. package/lib/templates/project/angularintapp/package.json +1 -1
  25. package/lib/templates/project/angularintapp/scripts/org-setup-config-schema.mjs +17 -0
  26. package/lib/templates/project/angularintapp/scripts/org-setup-utils.mjs +33 -3
  27. package/lib/templates/project/angularintapp/scripts/org-setup.mjs +535 -3
  28. package/lib/templates/project/reactexternalapp/CHANGELOG.md +1313 -0
  29. package/lib/templates/project/reactexternalapp/PRD.md +38 -0
  30. package/lib/templates/project/reactexternalapp/README.md +14 -10
  31. package/lib/templates/project/reactexternalapp/_p_/_m_/_ps_/reactexternalapp_Guest_User_Api_Access.permissionset-meta.xml +25 -0
  32. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/package-lock.json +660 -692
  33. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/package.json +9 -7
  34. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/scripts/get-graphql-schema.mjs +8 -5
  35. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/authentication/components/SocialLogin.tsx +141 -0
  36. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/authentication/pages/Login.tsx +2 -0
  37. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/api/distinctValuesService.ts +84 -0
  38. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/api/searchService.ts +71 -0
  39. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/MergedSearchResults.tsx +277 -0
  40. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/Search.tsx +185 -0
  41. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/SearchResults.tsx +77 -0
  42. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/SourceSection.tsx +182 -0
  43. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/controls/PaginationControls.tsx +185 -0
  44. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/controls/ScopeSelector.tsx +55 -0
  45. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/controls/SearchBar.tsx +55 -0
  46. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/controls/SortControl.tsx +62 -0
  47. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/ActiveFilters.tsx +61 -0
  48. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/DefaultFilterPanel.tsx +125 -0
  49. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/{_os_/components → search/components/filters}/FilterContext.tsx +7 -20
  50. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/BooleanFilter.tsx +50 -0
  51. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/DateRangeFilter.tsx +160 -0
  52. package/lib/templates/project/{reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters → reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs}/FilterFieldWrapper.tsx +11 -6
  53. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/MultiSelectFilter.tsx +89 -0
  54. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/NumericRangeFilter.tsx +108 -0
  55. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/SelectFilter.tsx +46 -0
  56. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/TextFilter.tsx +52 -0
  57. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/results/DefaultResultRow.tsx +109 -0
  58. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/config.json +83 -0
  59. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/{_os_ → search}/hooks/useAsyncData.ts +3 -10
  60. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/hooks/useDistinctValues.ts +59 -0
  61. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/hooks/useSearch.ts +703 -0
  62. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/index.ts +90 -0
  63. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/loadConfig.ts +14 -0
  64. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/queryBuilder.ts +156 -0
  65. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/types.ts +307 -0
  66. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/utils/debounce.ts +17 -0
  67. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/utils/fieldUtils.ts +14 -0
  68. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/utils/filterUtils.ts +285 -0
  69. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/search/utils/sortUtils.ts +34 -0
  70. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/api/graphqlClient.ts +24 -8
  71. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/appLayout.tsx +7 -0
  72. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/components/CustomerWebClientChat.tsx +74 -0
  73. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/{_f_/_os_/components → components}/ObjectBreadcrumb.tsx +7 -2
  74. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/components/ui/button.tsx +1 -1
  75. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/components/ui/datePicker.tsx +2 -2
  76. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/components/ui/table.tsx +9 -2
  77. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/index.ts +6 -0
  78. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/pages/AccountObjectDetailPage.tsx +49 -16
  79. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/pages/AccountSearch.tsx +21 -293
  80. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/pages/Home.tsx +22 -7
  81. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/pages/TestChatPage.tsx +26 -0
  82. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/routes.tsx +11 -5
  83. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/types/chat.ts +36 -0
  84. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/{_f_/_os_/utils/fieldUtils.ts → utils/accountFields.ts} +9 -0
  85. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/tsconfig.json +2 -2
  86. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/tsconfig.tsbuildinfo +1 -0
  87. package/lib/templates/project/reactexternalapp/_p_/_m_/classes/UIBundleSocialLoginConfig.cls +133 -0
  88. package/lib/templates/project/reactexternalapp/_p_/_m_/classes/UIBundleSocialLoginConfig.cls-meta.xml +5 -0
  89. package/lib/templates/project/reactexternalapp/_p_/_m_/classes/UIBundleSocialLoginConfig_Test.cls +101 -0
  90. package/lib/templates/project/reactexternalapp/_p_/_m_/classes/UIBundleSocialLoginConfig_Test.cls-meta.xml +5 -0
  91. package/lib/templates/project/reactexternalapp/_p_/_m_/package.xml +4 -0
  92. package/lib/templates/project/reactexternalapp/package.json +8 -2
  93. package/lib/templates/project/reactexternalapp/scripts/org-setup-config-schema.mjs +120 -0
  94. package/lib/templates/project/reactexternalapp/scripts/org-setup-dev.mjs +87 -0
  95. package/lib/templates/project/reactexternalapp/scripts/org-setup-utils.mjs +569 -0
  96. package/lib/templates/project/reactexternalapp/scripts/org-setup-xml.mjs +182 -0
  97. package/lib/templates/project/reactexternalapp/scripts/org-setup.config.json +6 -2
  98. package/lib/templates/project/reactexternalapp/scripts/org-setup.mjs +1509 -328
  99. package/lib/templates/project/reactexternalapp/scripts/validate-org-setup-config.mjs +38 -0
  100. package/lib/templates/project/reactinternalapp/CHANGELOG.md +1127 -0
  101. package/lib/templates/project/reactinternalapp/PRD.md +35 -0
  102. package/lib/templates/project/reactinternalapp/README.md +14 -10
  103. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/package-lock.json +509 -505
  104. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/package.json +9 -8
  105. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/api/distinctValuesService.ts +84 -0
  106. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/api/searchService.ts +71 -0
  107. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/MergedSearchResults.tsx +277 -0
  108. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/Search.tsx +185 -0
  109. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/SearchResults.tsx +77 -0
  110. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/SourceSection.tsx +182 -0
  111. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/controls/PaginationControls.tsx +185 -0
  112. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/controls/ScopeSelector.tsx +55 -0
  113. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/controls/SearchBar.tsx +55 -0
  114. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/controls/SortControl.tsx +62 -0
  115. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/ActiveFilters.tsx +61 -0
  116. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/DefaultFilterPanel.tsx +125 -0
  117. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/{_os_/components → search/components/filters}/FilterContext.tsx +7 -20
  118. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/BooleanFilter.tsx +50 -0
  119. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/DateRangeFilter.tsx +160 -0
  120. package/lib/templates/project/{reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters → reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs}/FilterFieldWrapper.tsx +11 -6
  121. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/MultiSelectFilter.tsx +89 -0
  122. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/NumericRangeFilter.tsx +108 -0
  123. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/SelectFilter.tsx +46 -0
  124. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/filters/inputs/TextFilter.tsx +52 -0
  125. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/components/results/DefaultResultRow.tsx +109 -0
  126. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/config.json +83 -0
  127. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/{_os_ → search}/hooks/useAsyncData.ts +3 -10
  128. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/hooks/useDistinctValues.ts +59 -0
  129. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/hooks/useSearch.ts +703 -0
  130. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/index.ts +90 -0
  131. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/loadConfig.ts +14 -0
  132. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/queryBuilder.ts +156 -0
  133. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/types.ts +307 -0
  134. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/utils/debounce.ts +17 -0
  135. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/utils/fieldUtils.ts +14 -0
  136. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/utils/filterUtils.ts +285 -0
  137. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/search/utils/sortUtils.ts +34 -0
  138. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/components/AgentforceConversationClient.tsx +16 -132
  139. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/{_f_/_os_/components → components}/ObjectBreadcrumb.tsx +7 -2
  140. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/components/ui/button.tsx +1 -1
  141. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/components/ui/datePicker.tsx +2 -2
  142. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/components/ui/table.tsx +9 -2
  143. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/pages/AccountObjectDetailPage.tsx +49 -16
  144. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/pages/AccountSearch.tsx +21 -293
  145. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/pages/Home.tsx +21 -6
  146. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/routes.tsx +4 -4
  147. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/{_f_/_os_/utils/fieldUtils.ts → utils/accountFields.ts} +9 -0
  148. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/tsconfig.json +2 -2
  149. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/tsconfig.tsbuildinfo +1 -0
  150. package/lib/templates/project/reactinternalapp/package.json +4 -2
  151. package/lib/templates/project/reactinternalapp/scripts/org-setup-config-schema.mjs +24 -0
  152. package/lib/templates/project/reactinternalapp/scripts/org-setup-dev.mjs +87 -0
  153. package/lib/templates/project/reactinternalapp/scripts/org-setup-utils.mjs +569 -0
  154. package/lib/templates/project/reactinternalapp/scripts/org-setup-xml.mjs +182 -0
  155. package/lib/templates/project/reactinternalapp/scripts/org-setup.mjs +1162 -214
  156. package/lib/templates/uiBundles/angularbasic/angular.json +1 -1
  157. package/lib/templates/uiBundles/angularbasic/eslint-plugin-angular-graphql.js +148 -0
  158. package/lib/templates/uiBundles/angularbasic/eslint.config.js +9 -1
  159. package/lib/templates/uiBundles/angularbasic/package-lock.json +421 -394
  160. package/lib/templates/uiBundles/angularbasic/package.json +2 -2
  161. package/lib/templates/uiBundles/reactbasic/package-lock.json +445 -418
  162. package/lib/utils/template-placeholders.js +7 -0
  163. package/lib/utils/template-placeholders.js.map +1 -1
  164. package/lib/utils/uiBundleTemplateUtils.d.ts +3 -1
  165. package/lib/utils/uiBundleTemplateUtils.js +4 -1
  166. package/lib/utils/uiBundleTemplateUtils.js.map +1 -1
  167. package/package.json +7 -7
  168. package/lib/templates/project/reactexternalapp/AGENT.md +0 -252
  169. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/api/accountSearchService.ts +0 -46
  170. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/api/query/distinctAccountIndustries.graphql +0 -19
  171. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/api/query/distinctAccountTypes.graphql +0 -19
  172. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/api/query/getAccountDetail.graphql +0 -121
  173. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/api/query/searchAccounts.graphql +0 -51
  174. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/pages/AccountObjectDetailPage.tsx +0 -355
  175. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/pages/AccountSearch.tsx +0 -304
  176. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/pages/Home.tsx +0 -34
  177. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/api/objectSearchService.ts +0 -82
  178. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/ActiveFilters.tsx +0 -89
  179. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/PaginationControls.tsx +0 -109
  180. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/SearchBar.tsx +0 -41
  181. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/SortControl.tsx +0 -143
  182. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/BooleanFilter.tsx +0 -78
  183. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/DateFilter.tsx +0 -128
  184. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/DateRangeFilter.tsx +0 -70
  185. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/MultiSelectFilter.tsx +0 -97
  186. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/NumericRangeFilter.tsx +0 -167
  187. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/SearchFilter.tsx +0 -52
  188. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/SelectFilter.tsx +0 -97
  189. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/TextFilter.tsx +0 -93
  190. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/hooks/useDebouncedCallback.ts +0 -34
  191. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/hooks/useObjectSearchParams.ts +0 -254
  192. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/utils/debounce.ts +0 -25
  193. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/utils/filterUtils.ts +0 -404
  194. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/utils/sortUtils.ts +0 -38
  195. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/api/account/accountSearchService.ts +0 -46
  196. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/api/account/query/distinctAccountIndustries.graphql +0 -19
  197. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/api/account/query/distinctAccountTypes.graphql +0 -19
  198. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/api/account/query/searchAccounts.graphql +0 -51
  199. package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/api/graphql-operations-types.ts +0 -11260
  200. package/lib/templates/project/reactexternalapp/scripts/prepare-import-unique-fields.js +0 -122
  201. package/lib/templates/project/reactinternalapp/AGENT.md +0 -252
  202. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/api/accountSearchService.ts +0 -46
  203. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/api/query/distinctAccountIndustries.graphql +0 -19
  204. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/api/query/distinctAccountTypes.graphql +0 -19
  205. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/api/query/getAccountDetail.graphql +0 -121
  206. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/api/query/searchAccounts.graphql +0 -51
  207. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/pages/AccountObjectDetailPage.tsx +0 -355
  208. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/pages/AccountSearch.tsx +0 -304
  209. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/_ex_/pages/Home.tsx +0 -34
  210. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/api/objectSearchService.ts +0 -82
  211. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/ActiveFilters.tsx +0 -89
  212. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/PaginationControls.tsx +0 -109
  213. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/SearchBar.tsx +0 -41
  214. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/SortControl.tsx +0 -143
  215. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/BooleanFilter.tsx +0 -78
  216. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/DateFilter.tsx +0 -128
  217. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/DateRangeFilter.tsx +0 -70
  218. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/MultiSelectFilter.tsx +0 -97
  219. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/NumericRangeFilter.tsx +0 -167
  220. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/SearchFilter.tsx +0 -52
  221. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/SelectFilter.tsx +0 -97
  222. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/components/filters/TextFilter.tsx +0 -93
  223. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/hooks/useDebouncedCallback.ts +0 -34
  224. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/hooks/useObjectSearchParams.ts +0 -254
  225. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/utils/debounce.ts +0 -25
  226. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/utils/filterUtils.ts +0 -404
  227. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/utils/sortUtils.ts +0 -38
  228. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/api/account/accountSearchService.ts +0 -46
  229. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/api/account/query/distinctAccountIndustries.graphql +0 -19
  230. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/api/account/query/distinctAccountTypes.graphql +0 -19
  231. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/api/account/query/searchAccounts.graphql +0 -51
  232. package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/api/graphql-operations-types.ts +0 -11260
  233. package/lib/templates/project/reactinternalapp/scripts/prepare-import-unique-fields.js +0 -122
  234. /package/lib/templates/project/angularextapp/_p_/_m_/{permissionsets → _ps_}/angularextapp_Guest_User_Api_Access.permissionset-meta.xml +0 -0
  235. /package/lib/templates/project/angularintapp/_p_/_m_/{permissionsets → _ps_}/angularintapp_Access.permissionset-meta.xml +0 -0
  236. /package/lib/templates/project/reactinternalapp/_p_/_m_/{permissionsets → _ps_}/reactinternalapp_Access.permissionset-meta.xml +0 -0
@@ -1,122 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Updates unique fields in data JSON files so "sf data import tree" can be run
4
- * repeatedly (e.g. after org already has data). Run before data import.
5
- *
6
- * Usage:
7
- * node scripts/prepare-import-unique-fields.js
8
- * node scripts/prepare-import-unique-fields.js --data-dir /path/to/<sfdx-source>/data
9
- *
10
- * Expects data dir to contain (optional) JSON files:
11
- * Contact.json (Email with unique domain per run, LastName, FirstName, Phone — standard Contact)
12
- * Agent__c.json (License_Number__c — unique per record)
13
- * Property_Management_Company__c.json (Company_Code__c, max 10 chars)
14
- * Property_Owner__c.json (Email__c)
15
- * Missing files are skipped. Customize this script for your app's objects/fields.
16
- */
17
-
18
- const fs = require('fs');
19
- const path = require('path');
20
-
21
- function resolveSfdxSource() {
22
- const sfdxPath = path.resolve(__dirname, '..', 'sfdx-project.json');
23
- if (!fs.existsSync(sfdxPath)) {
24
- console.error('Error: sfdx-project.json not found at project root.');
25
- process.exit(1);
26
- }
27
- const sfdxProject = JSON.parse(fs.readFileSync(sfdxPath, 'utf8'));
28
- const pkgDir = sfdxProject?.packageDirectories?.[0]?.path;
29
- if (!pkgDir) {
30
- console.error('Error: No packageDirectories[].path found in sfdx-project.json.');
31
- process.exit(1);
32
- }
33
- return path.resolve(__dirname, '..', pkgDir, 'main', 'default');
34
- }
35
-
36
- const DEFAULT_DATA_DIR = path.resolve(resolveSfdxSource(), 'data');
37
-
38
- function parseArgs() {
39
- const args = process.argv.slice(2);
40
- let dataDir = DEFAULT_DATA_DIR;
41
- for (let i = 0; i < args.length; i++) {
42
- if (args[i] === '--data-dir' && args[i + 1]) {
43
- dataDir = path.resolve(args[++i]);
44
- break;
45
- }
46
- }
47
- return dataDir;
48
- }
49
-
50
- const dataDir = parseArgs();
51
- const runId = Date.now();
52
- const runSuffix2 = String(runId % 100).padStart(2, '0'); // 00-99 for Company_Code__c (10-char limit)
53
-
54
- // Contact: Email (unique domain + local), LastName, FirstName, Phone — avoid duplicate rules
55
- const contactPath = path.join(dataDir, 'Contact.json');
56
- if (fs.existsSync(contactPath)) {
57
- let contact = JSON.parse(fs.readFileSync(contactPath, 'utf8'));
58
- if (contact.records) {
59
- contact.records.forEach((r, i) => {
60
- if (r.Email && r.Email.includes('@')) {
61
- const parts = r.Email.replace(/\+[0-9]+@/, '@').split('@');
62
- const local = (parts[0] || 'user') + '+' + runId;
63
- const domain = 'run' + runId + '.example.com';
64
- r.Email = local + '@' + domain;
65
- }
66
- if (r.LastName)
67
- r.LastName = String(r.LastName).replace(/-[0-9]+$/, '') + '-' + runId;
68
- if (r.FirstName)
69
- r.FirstName = String(r.FirstName).replace(/-[0-9]+$/, '') + '-' + (i + 1);
70
- if (r.Phone)
71
- r.Phone = String(r.Phone).replace(/\d{2}$/, runSuffix2);
72
- });
73
- fs.writeFileSync(contactPath, JSON.stringify(contact, null, 2));
74
- console.log('Updated Contact.json (Email, LastName, FirstName, Phone)');
75
- }
76
- }
77
-
78
- // Agent__c: License_Number__c — unique per record (field is often unique in org)
79
- const agentPath = path.join(dataDir, 'Agent__c.json');
80
- if (fs.existsSync(agentPath)) {
81
- let agent = JSON.parse(fs.readFileSync(agentPath, 'utf8'));
82
- if (agent.records) {
83
- agent.records.forEach((r, i) => {
84
- if (r.License_Number__c) {
85
- const base = r.License_Number__c.replace(/-[0-9]+(-[0-9]+)?$/, '');
86
- r.License_Number__c = base + '-' + runId + '-' + (i + 1);
87
- }
88
- });
89
- fs.writeFileSync(agentPath, JSON.stringify(agent, null, 2));
90
- console.log('Updated Agent__c.json (License_Number__c)');
91
- }
92
- }
93
-
94
- // Property_Management_Company__c: Company_Code__c — max 10 chars, use 8-char base + 2-digit suffix
95
- const companyPath = path.join(dataDir, 'Property_Management_Company__c.json');
96
- if (fs.existsSync(companyPath)) {
97
- let company = JSON.parse(fs.readFileSync(companyPath, 'utf8'));
98
- if (company.records) {
99
- company.records.forEach((r) => {
100
- if (r.Company_Code__c)
101
- r.Company_Code__c = r.Company_Code__c.slice(0, 8) + runSuffix2;
102
- });
103
- fs.writeFileSync(companyPath, JSON.stringify(company, null, 2));
104
- console.log('Updated Property_Management_Company__c.json (Company_Code__c)');
105
- }
106
- }
107
-
108
- // Property_Owner__c: Email__c — add +runId before @
109
- const ownerPath = path.join(dataDir, 'Property_Owner__c.json');
110
- if (fs.existsSync(ownerPath)) {
111
- let owner = JSON.parse(fs.readFileSync(ownerPath, 'utf8'));
112
- if (owner.records) {
113
- owner.records.forEach((r) => {
114
- if (r.Email__c && r.Email__c.includes('@'))
115
- r.Email__c = r.Email__c.replace(/\+[0-9]+@/, '@').replace('@', '+' + runId + '@');
116
- });
117
- fs.writeFileSync(ownerPath, JSON.stringify(owner, null, 2));
118
- console.log('Updated Property_Owner__c.json (Email__c)');
119
- }
120
- }
121
-
122
- console.log('Unique fields updated: runId=%s companySuffix=%s', runId, runSuffix2);
@@ -1,252 +0,0 @@
1
- # Agent guide: Salesforce UI Bundle development
2
-
3
- This project is a **Salesforce DX (SFDX) project** containing a **React UI Bundle**. The UI Bundle is a standalone Vite + React SPA that runs inside the Salesforce platform. Use this file when working in this project.
4
-
5
- ## Resolving paths
6
-
7
- Read `sfdx-project.json` at the project root. Take the first `packageDirectories[].path` value and append `/main/default` to get `<sfdx-source>`. The UI Bundle directory is:
8
-
9
- ```
10
- <sfdx-source>/uiBundles/<appName>/
11
- ```
12
-
13
- Replace `<appName>` with the actual folder name found under `uiBundles/`. The source path is **not** always `force-app` — always resolve it from `sfdx-project.json`.
14
-
15
- ## Project layout
16
-
17
- ```
18
- <project-root>/
19
- ├── sfdx-project.json
20
- ├── package.json # SFDX root scripts
21
- ├── scripts/
22
- │ ├── org-setup.mjs # One-time org setup (deploy, schema, build)
23
- │ └── graphql-search.sh # Schema entity lookup
24
- ├── config/
25
- │ └── project-scratch-def.json
26
- │
27
- └── <sfdx-source>/
28
- ├── uiBundles/
29
- │ └── <appName>/ # ← React UI Bundle (primary workspace)
30
- │ ├── <appName>.uibundle-meta.xml
31
- │ ├── ui-bundle.json
32
- │ ├── index.html
33
- │ ├── package.json
34
- │ ├── vite.config.ts / tsconfig.json
35
- │ ├── vitest.config.ts / playwright.config.ts
36
- │ ├── codegen.yml / .graphqlrc.yml
37
- │ └── src/ # All application code lives here
38
- │
39
- ├── classes/ # Apex classes (optional)
40
- ├── objects/ # Custom objects and fields (optional)
41
- ├── permissionsets/ # Permission sets (optional)
42
- ├── cspTrustedSites/ # CSP trusted site definitions (optional)
43
- ├── layouts/ # Object layouts (optional)
44
- ├── triggers/ # Apex triggers (optional)
45
- └── data/ # Sample data for import (optional)
46
- ```
47
-
48
- ## UI Bundle source structure
49
-
50
- All application code lives inside the UI Bundle's `src/` directory:
51
-
52
- ```
53
- src/
54
- ├── app.tsx # Entry point — creates the browser router
55
- ├── appLayout.tsx # Shell layout (header, navigation, Outlet, footer)
56
- ├── routes.tsx # Single route registry for the entire app
57
- ├── navigationMenu.tsx # Navigation component
58
- ├── router-utils.tsx # Router helpers
59
- ├── lib/utils.ts # Utility functions (cn, etc.)
60
- ├── styles/global.css # Tailwind global styles
61
- ├── api/ # GraphQL operations, clients, data services
62
- ├── assets/ # Static SVGs, images
63
- ├── components/
64
- │ ├── ui/ # Shared primitives (shadcn-style: button, card, input, etc.)
65
- │ ├── layout/ # Layout components (header, footer, sidebar)
66
- │ └── <feature>/ # Feature-specific components
67
- ├── features/ # Feature modules (auth, search, etc.)
68
- ├── hooks/ # Custom React hooks
69
- ├── pages/ # Page components (one per route)
70
- ├── public/ # Static assets served as-is
71
- └── utils/ # Shared utilities
72
- ```
73
-
74
- ### Key files
75
-
76
- | File | Role |
77
- |------|------|
78
- | `app.tsx` | Creates `BrowserRouter`; do not add UI here |
79
- | `appLayout.tsx` | Source of truth for navigation, header, footer, and page shell |
80
- | `routes.tsx` | Single route registry; all pages are children of the layout route |
81
- | `<appName>.uibundle-meta.xml` | Salesforce deploy descriptor (`masterLabel`, `version`, `isActive`) |
82
- | `ui-bundle.json` | Runtime config (`outputDir`, routing) |
83
-
84
- ## Two package.json contexts
85
-
86
- ### 1. Project root
87
-
88
- Used for SFDX metadata tooling. Scripts here target LWC/Aura, not the React app.
89
-
90
- | Command | Purpose |
91
- |---------|---------|
92
- | `npm run test` | LWC Jest (passWithNoTests) |
93
- | `npm run prettier` | Format metadata files |
94
- | `npm run prettier:verify` | Check Prettier |
95
-
96
- **One-time org setup:** `node scripts/org-setup.mjs --target-org <alias>` runs login, deploy, permset assignment, data import, GraphQL schema/codegen, UI Bundle build, and optionally the dev server. Use `--help` for all flags.
97
-
98
- ### 2. UI Bundle directory (primary workspace)
99
-
100
- **ALL dev, build, lint, and test commands MUST be run from inside the UI Bundle directory (`<sfdx-source>/uiBundles/<appName>/`). Never run them from the project root.**
101
-
102
- Resolve the correct path from `sfdx-project.json` before running any command. Do not hardcode the path.
103
-
104
- | Command | Purpose |
105
- |---------|---------|
106
- | `npm run dev` | Start Vite dev server |
107
- | `npm run build` | TypeScript check + Vite production build |
108
- | `npm run lint` | ESLint for the React app |
109
- | `npm run test` | Vitest unit tests |
110
- | `npm run preview` | Preview production build |
111
- | `npm run graphql:codegen` | Generate GraphQL types from schema |
112
- | `npm run graphql:schema` | Fetch GraphQL schema from org |
113
-
114
- **After every task, without exception:**
115
- 1. Run `npm run build` from the UI Bundle directory — must pass with zero errors.
116
- 2. Run `npm run lint` from the UI Bundle directory — must pass with zero errors.
117
- 3. Run `npm run dev` to start the dev server so the user can verify the result.
118
-
119
- Do not consider a task complete until all three steps have been run successfully.
120
- ## Development conventions
121
-
122
- ### UI
123
-
124
- - **Component library:** shadcn/ui primitives in `src/components/ui/`. Always use these over raw HTML equivalents. **Before importing any component, verify both the file exists in `src/components/ui/` AND the named export exists within that file.** Never assume a component or export is available — read the file to confirm the exact exports before importing.
125
- - **Styling:** Tailwind CSS only. No inline `style={{}}`. Use `cn()` from `@/lib/utils` for conditional classes.
126
- - **Icons:** Lucide React.
127
- - **Path alias:** `@/*` maps to `src/*`. Use it for all imports.
128
- - **TypeScript:** No `any`. Use proper types, generics, or `unknown`.
129
- - **Components:** Accept `className?: string` prop. Extract shared state to custom hooks in `src/hooks/`.
130
- - **React apps must not** import Salesforce platform modules (`lightning/*`, `@wire`, LWC APIs).
131
-
132
- ### Routing
133
-
134
- - React Router with `createBrowserRouter`. Route definitions live exclusively in `routes.tsx`.
135
- - All page routes are children of the layout route (which renders `appLayout.tsx`).
136
- - Default-export one component per page file.
137
- - The catch-all `path: '*'` route must always be last.
138
- - Navigation uses absolute paths (`/dashboard`). Non-router imports use dot-relative paths (`./utils`).
139
- - Navigation visibility is driven by `handle.showInNavigation` on route definitions.
140
-
141
- ### Layout and navigation
142
-
143
- - `appLayout.tsx` owns the header, navigation menu, footer, and `<Outlet />`.
144
- - To modify header or footer, edit `appLayout.tsx` and create components in `src/components/layout/`.
145
- - To add a page, add a route in `routes.tsx` and create the page component — do not modify `appLayout.tsx` or `app.tsx` for page additions.
146
-
147
- ### Data access (Salesforce)
148
-
149
- **Before writing any code that connects to Salesforce, you MUST invoke the `using-ui-bundle-salesforce-data` skill. Do not write any data access code without consulting it first.**
150
-
151
- This applies to: GraphQL queries/mutations, REST calls, SDK initialization, custom hooks that fetch data, or any code that imports from `@salesforce/platform-sdk`.
152
-
153
- - **All data access uses the Data SDK** (`@salesforce/platform-sdk`) via `createDataSDK()`.
154
- - **Never** use `fetch()` or `axios` directly for Salesforce data.
155
- - **GraphQL is preferred** for record operations (`sdk.graphql`). Use `sdk.fetch` only when GraphQL cannot cover the case (UI API REST, Apex REST, Connect REST, Einstein LLM).
156
- - Use optional chaining: `sdk.graphql?.()`, `sdk.fetch?.()`.
157
- - Apply the `@optional` directive to all record fields for field-level security resilience.
158
- - Verify field and object names via `scripts/graphql-search.sh` before writing queries.
159
- - Use `__SF_API_VERSION__` global for API version in REST calls.
160
- - **Blocked APIs:** Enterprise REST query endpoint (`/query` with SOQL), `@AuraEnabled` Apex, Chatter API.
161
-
162
- #### Permitted APIs
163
-
164
- | API | Method | Endpoints / Use Case |
165
- |-----|--------|----------------------|
166
- | GraphQL | `sdk.graphql` | All record queries and mutations via `uiapi { }` namespace |
167
- | UI API REST | `sdk.fetch` | `/services/data/v{ver}/ui-api/records/{id}` |
168
- | Apex REST | `sdk.fetch` | `/services/apexrest/{resource}` |
169
- | Connect REST | `sdk.fetch` | `/services/data/v{ver}/connect/...` |
170
- | Einstein LLM | `sdk.fetch` | `/services/data/v{ver}/einstein/llm/prompt/generations` |
171
-
172
- Any endpoint not listed above is not permitted.
173
-
174
- #### GraphQL non-negotiable rules
175
-
176
- 1. **Schema is the single source of truth** — every entity and field name must be confirmed via the schema search script before use. Never guess.
177
- 2. **`@optional` on all record fields** — FLS causes entire queries to fail if any field is inaccessible. Apply to every scalar, parent, and child relationship field.
178
- 3. **Correct mutation syntax** — mutations wrap under `uiapi(input: { allOrNone: true/false })`, not bare `uiapi { ... }`.
179
- 4. **Explicit `first:` in every query** — omitting it silently defaults to 10 records. Always include `pageInfo { hasNextPage endCursor }` for paginated queries.
180
- 5. **SOQL-derived execution limits** — max 10 subqueries per request, max 5 levels of child-to-parent traversal, max 1 level parent-to-child, max 2,000 records per subquery.
181
- 6. **HTTP 200 does not mean success** — Salesforce returns HTTP 200 even on failure. Always check the `errors` array in the response body.
182
-
183
- #### GraphQL inline queries
184
- Must use the `gql` template tag from `@salesforce/platform-sdk` — plain template strings bypass `@graphql-eslint` schema validation. For complex queries, use external `.graphql` files with codegen.
185
-
186
- #### Current user info
187
- Use GraphQL (`uiapi { currentUser { Id Name { value } } }`), not Chatter (`/chatter/users/me`).
188
-
189
- #### Schema file (`schema.graphql`)
190
-
191
- The `schema.graphql` file at the SFDX project root is the source of truth for all entity and field name lookups. It is 265K+ lines — never open or parse it directly. Use the schema search script instead.
192
-
193
- - **Generate/refresh:** Run `npm run graphql:schema` from the UI bundle directory
194
- - **When to regenerate:** After any metadata deployment that changes objects, fields, or permission sets
195
- - **Custom objects** only appear in the schema after metadata deployment AND permission set assignment
196
- - **After regenerating:** Always re-run `npm run graphql:codegen` and `npm run build` (schema changes may affect generated types)
197
-
198
- ### CSP trusted sites
199
-
200
- Any external domain the app calls (APIs, CDNs, fonts) must have a `.cspTrustedSite-meta.xml` file under `<sfdx-source>/cspTrustedSites/`. Unregistered domains are blocked at runtime. Each subdomain needs its own entry. URLs must be HTTPS with no trailing slash, no path, and no wildcards.
201
-
202
- ## Building and launching the app
203
-
204
- All build, dev, and test commands run from the UI Bundle directory. Before running any command, read the UI Bundle's `package.json` to confirm available scripts — do not assume script names.
205
-
206
- Typical scripts found in the UI Bundle:
207
-
208
- | Command | Purpose |
209
- |---------|---------|
210
- | `npm run build` | TypeScript check + Vite production build |
211
- | `npm run dev` | Start Vite dev server |
212
- | `npm run lint` | ESLint |
213
- | `npm run test` | Vitest unit tests |
214
- | `npm run graphql:codegen` | Generate GraphQL types |
215
- | `npm run graphql:schema` | Fetch GraphQL schema from org |
216
-
217
- If dependencies have not been installed yet, run `npm install` in the UI Bundle directory first. Alternatively, run `npm run sf-project-setup` from the project root — it resolves the UI Bundle directory automatically and runs install, build, and dev in sequence.
218
-
219
- **After any JavaScript or TypeScript change, run `npm run build` to validate the change.** If the build fails, read the error output, identify the cause, fix it, and run `npm run build` again. Do not move on until the build passes.
220
-
221
- ## Deploying
222
-
223
- **Deployment order matters.** Metadata (objects, permission sets) must be deployed before fetching the GraphQL schema. After any metadata deployment that changes objects, fields, or permissions, re-run schema fetch and codegen.
224
-
225
- **Deployment steps:**
226
-
227
- 1. Authenticate to the target org
228
- 2. Build the UI Bundle (`npm run build` in the UI Bundle directory)
229
- 3. Deploy metadata (`sf project deploy start --source-dir <packageDir> --target-org <alias>`)
230
-
231
- ```bash
232
- # Deploy UI Bundle only
233
- sf project deploy start --source-dir <sfdx-source>/ui-bundles --target-org <alias>
234
-
235
- # Deploy all metadata
236
- sf project deploy start --source-dir <packageDir> --target-org <alias>
237
- ```
238
-
239
- **Do not open the app after deployment.** Do not run `sf org open`, do not guess the runtime URL, and do not construct paths like `/s/<appName>`. Deployment is complete when the `sf project deploy start` command succeeds.
240
-
241
- ## Post-deployment org setup
242
-
243
- These steps apply after a fresh deployment to configure the org. They are not part of routine deployment.
244
-
245
- 1. Assign permission sets
246
- 2. Import data (only with user confirmation)
247
- 3. Fetch GraphQL schema + run codegen (`npm run graphql:schema && npm run graphql:codegen`)
248
- 4. Rebuild the UI Bundle (`npm run build` — schema changes may affect generated types)
249
-
250
- ## Skills
251
-
252
- Before starting any task, check whether a relevant skill exists. If one does, invoke it before writing any code or making any implementation decision. Skills are the authoritative source for patterns, constraints, and code examples.
@@ -1,46 +0,0 @@
1
- import SEARCH_ACCOUNTS_QUERY from "./query/searchAccounts.graphql?raw";
2
- import DISTINCT_INDUSTRIES_QUERY from "./query/distinctAccountIndustries.graphql?raw";
3
- import DISTINCT_TYPES_QUERY from "./query/distinctAccountTypes.graphql?raw";
4
- import {
5
- searchObjects,
6
- fetchDistinctValues,
7
- type ObjectSearchOptions,
8
- type PicklistOption,
9
- } from "../../api/objectSearchService";
10
- import type {
11
- SearchAccountsQuery,
12
- SearchAccountsQueryVariables,
13
- DistinctAccountIndustriesQuery,
14
- DistinctAccountTypesQuery,
15
- } from "../../../../api/graphql-operations-types";
16
-
17
- export type AccountSearchResult = NonNullable<SearchAccountsQuery["uiapi"]["query"]["Account"]>;
18
-
19
- export type AccountSearchOptions = ObjectSearchOptions<
20
- SearchAccountsQueryVariables["where"],
21
- SearchAccountsQueryVariables["orderBy"]
22
- >;
23
-
24
- export type { PicklistOption };
25
-
26
- export async function searchAccounts(
27
- options: AccountSearchOptions = {},
28
- ): Promise<AccountSearchResult> {
29
- return searchObjects<AccountSearchResult, SearchAccountsQuery, SearchAccountsQueryVariables>(
30
- SEARCH_ACCOUNTS_QUERY,
31
- "Account",
32
- options,
33
- );
34
- }
35
-
36
- export async function fetchDistinctIndustries(): Promise<PicklistOption[]> {
37
- return fetchDistinctValues<DistinctAccountIndustriesQuery>(
38
- DISTINCT_INDUSTRIES_QUERY,
39
- "Account",
40
- "Industry",
41
- );
42
- }
43
-
44
- export async function fetchDistinctTypes(): Promise<PicklistOption[]> {
45
- return fetchDistinctValues<DistinctAccountTypesQuery>(DISTINCT_TYPES_QUERY, "Account", "Type");
46
- }
@@ -1,19 +0,0 @@
1
- query DistinctAccountIndustries {
2
- uiapi {
3
- aggregate {
4
- Account(groupBy: { Industry: { group: true } }) {
5
- edges {
6
- node {
7
- aggregate @optional {
8
- Industry @optional {
9
- value
10
- displayValue
11
- label
12
- }
13
- }
14
- }
15
- }
16
- }
17
- }
18
- }
19
- }
@@ -1,19 +0,0 @@
1
- query DistinctAccountTypes {
2
- uiapi {
3
- aggregate {
4
- Account(groupBy: { Type: { group: true } }) {
5
- edges {
6
- node {
7
- aggregate @optional {
8
- Type @optional {
9
- value
10
- displayValue
11
- label
12
- }
13
- }
14
- }
15
- }
16
- }
17
- }
18
- }
19
- }
@@ -1,121 +0,0 @@
1
- query GetAccountDetail($id: ID!) {
2
- uiapi {
3
- query {
4
- Account(where: { Id: { eq: $id } }) {
5
- edges {
6
- node {
7
- Id
8
- Name @optional {
9
- value
10
- displayValue
11
- }
12
- Owner @optional {
13
- Name @optional {
14
- value
15
- displayValue
16
- }
17
- }
18
- Phone @optional {
19
- value
20
- displayValue
21
- }
22
- Fax @optional {
23
- value
24
- displayValue
25
- }
26
- Parent @optional {
27
- Name @optional {
28
- value
29
- displayValue
30
- }
31
- }
32
- Website @optional {
33
- value
34
- displayValue
35
- }
36
- Type @optional {
37
- value
38
- displayValue
39
- }
40
- NumberOfEmployees @optional {
41
- value
42
- displayValue
43
- }
44
- Industry @optional {
45
- value
46
- displayValue
47
- }
48
- AnnualRevenue @optional {
49
- value
50
- displayValue
51
- }
52
- Description @optional {
53
- value
54
- displayValue
55
- }
56
- BillingStreet @optional {
57
- value
58
- displayValue
59
- }
60
- BillingCity @optional {
61
- value
62
- displayValue
63
- }
64
- BillingState @optional {
65
- value
66
- displayValue
67
- }
68
- BillingPostalCode @optional {
69
- value
70
- displayValue
71
- }
72
- BillingCountry @optional {
73
- value
74
- displayValue
75
- }
76
- ShippingStreet @optional {
77
- value
78
- displayValue
79
- }
80
- ShippingCity @optional {
81
- value
82
- displayValue
83
- }
84
- ShippingState @optional {
85
- value
86
- displayValue
87
- }
88
- ShippingPostalCode @optional {
89
- value
90
- displayValue
91
- }
92
- ShippingCountry @optional {
93
- value
94
- displayValue
95
- }
96
- CreatedBy @optional {
97
- Name @optional {
98
- value
99
- displayValue
100
- }
101
- }
102
- CreatedDate @optional {
103
- value
104
- displayValue
105
- }
106
- LastModifiedBy @optional {
107
- Name @optional {
108
- value
109
- displayValue
110
- }
111
- }
112
- LastModifiedDate @optional {
113
- value
114
- displayValue
115
- }
116
- }
117
- }
118
- }
119
- }
120
- }
121
- }
@@ -1,51 +0,0 @@
1
- query SearchAccounts(
2
- $first: Int
3
- $after: String
4
- $where: Account_Filter
5
- $orderBy: Account_OrderBy
6
- ) {
7
- uiapi {
8
- query {
9
- Account(first: $first, after: $after, where: $where, orderBy: $orderBy) {
10
- edges {
11
- node {
12
- Id
13
- Name @optional {
14
- value
15
- displayValue
16
- }
17
- Industry @optional {
18
- value
19
- displayValue
20
- }
21
- Type @optional {
22
- value
23
- displayValue
24
- }
25
- Phone @optional {
26
- value
27
- displayValue
28
- }
29
- Owner @optional {
30
- Name @optional {
31
- value
32
- displayValue
33
- }
34
- }
35
- AnnualRevenue @optional {
36
- value
37
- displayValue
38
- }
39
- }
40
- }
41
- pageInfo {
42
- hasNextPage
43
- hasPreviousPage
44
- endCursor
45
- startCursor
46
- }
47
- totalCount
48
- }
49
- }
50
- }
51
- }