@asteby/metacore-runtime-react 53.25.0 → 53.27.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 (387) hide show
  1. package/CHANGELOG.md +23 -0
  2. package/dist/action-modal-dispatcher.d.ts +3 -3
  3. package/dist/action-modal-dispatcher.d.ts.map +1 -1
  4. package/dist/action-modal-dispatcher.js +36 -31
  5. package/dist/action-priority.d.ts +1 -1
  6. package/dist/activity-diff.d.ts +1 -1
  7. package/dist/activity-diff.js +1 -1
  8. package/dist/activity-timeline.d.ts +2 -2
  9. package/dist/activity-timeline.js +3 -3
  10. package/dist/activity-value-renderer.d.ts +1 -1
  11. package/dist/activity-value-renderer.js +3 -3
  12. package/dist/addon-loader.d.ts +1 -1
  13. package/dist/addon-loader.js +3 -3
  14. package/dist/addon-page-host.js +1 -1
  15. package/dist/addon-page-loader.d.ts +2 -2
  16. package/dist/addon-page-loader.js +3 -3
  17. package/dist/api-context.js +4 -4
  18. package/dist/approval-gate.d.ts +1 -1
  19. package/dist/approval-gate.js +5 -5
  20. package/dist/assist-interview.d.ts +1 -1
  21. package/dist/assist-interview.js +1 -1
  22. package/dist/attention/index.d.ts +3 -3
  23. package/dist/attention/index.js +3 -3
  24. package/dist/attention/use-nav-badges.js +2 -2
  25. package/dist/attribute-classes.d.ts +1 -1
  26. package/dist/audit-info.d.ts +1 -1
  27. package/dist/audit-info.js +5 -5
  28. package/dist/bulk-image-dialog.d.ts +1 -1
  29. package/dist/bulk-image-dialog.js +5 -5
  30. package/dist/bulk-image-import.d.ts +2 -2
  31. package/dist/bulk-image-import.js +1 -1
  32. package/dist/bulk-image-target.d.ts +1 -1
  33. package/dist/bulk-image-target.js +1 -1
  34. package/dist/bulk-image-wizard.d.ts +1 -1
  35. package/dist/bulk-image-wizard.js +5 -5
  36. package/dist/business/catalog-product-search.d.ts +1 -1
  37. package/dist/business/customer-picker.js +4 -4
  38. package/dist/business/document-editor-model.d.ts +3 -3
  39. package/dist/business/document-editor-model.js +4 -4
  40. package/dist/business/document-editor-panels.d.ts +3 -3
  41. package/dist/business/document-editor-panels.js +1 -1
  42. package/dist/business/document-editor.d.ts +2 -2
  43. package/dist/business/document-editor.js +22 -22
  44. package/dist/business/document-lines.d.ts +2 -2
  45. package/dist/business/document-lines.js +3 -3
  46. package/dist/business/field-errors.d.ts +1 -1
  47. package/dist/business/field-errors.js +1 -1
  48. package/dist/business/format.js +1 -1
  49. package/dist/business/index.d.ts +29 -29
  50. package/dist/business/index.js +29 -29
  51. package/dist/business/inspection-checklist.d.ts +1 -1
  52. package/dist/business/inspection-checklist.js +2 -2
  53. package/dist/business/inspection.d.ts +1 -1
  54. package/dist/business/inspection.js +2 -2
  55. package/dist/business/line-items-editor.d.ts +3 -3
  56. package/dist/business/line-items-editor.js +5 -5
  57. package/dist/business/line-items.d.ts +1 -1
  58. package/dist/business/line-items.js +2 -2
  59. package/dist/business/line-product-cell.d.ts +2 -2
  60. package/dist/business/line-product-cell.js +2 -2
  61. package/dist/business/payment-allocator.d.ts +1 -1
  62. package/dist/business/payment-allocator.js +2 -2
  63. package/dist/business/payment-capture.d.ts +1 -1
  64. package/dist/business/payment-capture.js +3 -3
  65. package/dist/business/payment.js +1 -1
  66. package/dist/business/print-send-dialog.js +1 -1
  67. package/dist/business/product-display.d.ts +1 -1
  68. package/dist/business/product-options.d.ts +1 -1
  69. package/dist/business/product-options.js +4 -4
  70. package/dist/business/product-picker.d.ts +1 -1
  71. package/dist/business/product-picker.js +3 -3
  72. package/dist/business/product-search.d.ts +2 -2
  73. package/dist/business/product-search.js +1 -1
  74. package/dist/business/refund-destination.d.ts +1 -1
  75. package/dist/business/refund-destination.js +2 -2
  76. package/dist/business/refund.js +1 -1
  77. package/dist/business/relate-documents.js +1 -1
  78. package/dist/business/return-wizard.d.ts +2 -2
  79. package/dist/business/return-wizard.js +4 -4
  80. package/dist/business/return.d.ts +2 -2
  81. package/dist/business/return.js +2 -2
  82. package/dist/business/vehicle-picker.js +3 -3
  83. package/dist/cache-coherence.js +3 -3
  84. package/dist/capability-providers/index.d.ts +3 -3
  85. package/dist/capability-providers/index.js +3 -3
  86. package/dist/capability-providers/provider-sortable-list.d.ts +1 -1
  87. package/dist/capability-providers/provider-sortable-list.js +1 -1
  88. package/dist/collection-cell.js +1 -1
  89. package/dist/column-filter-field.d.ts +1 -1
  90. package/dist/column-visibility.d.ts +1 -1
  91. package/dist/custom-stages.d.ts +2 -2
  92. package/dist/custom-stages.js +1 -1
  93. package/dist/dashboard-grid.d.ts +1 -1
  94. package/dist/dashboard-grid.js +3 -3
  95. package/dist/dialogs/create-record-dialog.d.ts +1 -1
  96. package/dist/dialogs/create-record-dialog.js +1 -1
  97. package/dist/dialogs/dynamic-record.d.ts +15 -5
  98. package/dist/dialogs/dynamic-record.d.ts.map +1 -1
  99. package/dist/dialogs/dynamic-record.js +47 -41
  100. package/dist/dialogs/export.d.ts +1 -1
  101. package/dist/dialogs/export.js +2 -2
  102. package/dist/dialogs/import.d.ts +1 -1
  103. package/dist/dialogs/import.js +3 -3
  104. package/dist/dialogs/inline-relation-rows.d.ts +3 -3
  105. package/dist/dialogs/inline-relation-rows.js +3 -3
  106. package/dist/dialogs/inline-relations.d.ts +3 -3
  107. package/dist/dialogs/inline-relations.js +3 -3
  108. package/dist/dialogs/normalize-submit.d.ts +1 -1
  109. package/dist/dialogs/normalize-submit.js +3 -3
  110. package/dist/dialogs/use-inline-relations.d.ts +1 -1
  111. package/dist/dialogs/use-inline-relations.js +3 -3
  112. package/dist/dialogs/view-record-dialog.d.ts +1 -1
  113. package/dist/dialogs/view-record-dialog.js +1 -1
  114. package/dist/display-value.js +1 -1
  115. package/dist/document/action-bar.d.ts +1 -1
  116. package/dist/document/action-bar.js +1 -1
  117. package/dist/document/document-header.d.ts +2 -2
  118. package/dist/document/document-header.js +2 -2
  119. package/dist/document/document-page.d.ts +3 -3
  120. package/dist/document/document-page.js +9 -9
  121. package/dist/document/document-timeline.d.ts +2 -2
  122. package/dist/document/document-timeline.js +2 -2
  123. package/dist/document/evaluate.d.ts +1 -1
  124. package/dist/document/evaluate.js +1 -1
  125. package/dist/document/format.d.ts +1 -1
  126. package/dist/document/index.d.ts +13 -13
  127. package/dist/document/index.js +13 -13
  128. package/dist/document/registry.d.ts +1 -1
  129. package/dist/document/secondary-bar.js +2 -2
  130. package/dist/document/smart-buttons.js +1 -1
  131. package/dist/document/status-badge.d.ts +1 -1
  132. package/dist/document/use-document-sources.d.ts +1 -1
  133. package/dist/document/use-document-sources.js +2 -2
  134. package/dist/document-form-dialog.d.ts +2 -2
  135. package/dist/document-form-dialog.js +16 -16
  136. package/dist/document-template-editor.js +1 -1
  137. package/dist/dynamic-columns-shim.d.ts +1 -1
  138. package/dist/dynamic-columns.d.ts +3 -3
  139. package/dist/dynamic-columns.js +19 -19
  140. package/dist/dynamic-crud-page.d.ts +2 -2
  141. package/dist/dynamic-crud-page.js +13 -13
  142. package/dist/dynamic-date-field.d.ts +1 -1
  143. package/dist/dynamic-date-field.js +1 -1
  144. package/dist/dynamic-form-schema.d.ts +2 -2
  145. package/dist/dynamic-form-schema.js +4 -4
  146. package/dist/dynamic-form.d.ts +10 -10
  147. package/dist/dynamic-form.d.ts.map +1 -1
  148. package/dist/dynamic-form.js +31 -24
  149. package/dist/dynamic-icon.js +1 -1
  150. package/dist/dynamic-kanban.d.ts +3 -3
  151. package/dist/dynamic-kanban.js +25 -25
  152. package/dist/dynamic-line-items.d.ts +1 -1
  153. package/dist/dynamic-line-items.d.ts.map +1 -1
  154. package/dist/dynamic-line-items.js +11 -6
  155. package/dist/dynamic-multi-select-field.d.ts +1 -1
  156. package/dist/dynamic-multi-select-field.d.ts.map +1 -1
  157. package/dist/dynamic-multi-select-field.js +12 -12
  158. package/dist/dynamic-relation-helpers.d.ts +1 -1
  159. package/dist/dynamic-relation-helpers.js +2 -2
  160. package/dist/dynamic-relation.d.ts +2 -2
  161. package/dist/dynamic-relation.js +15 -15
  162. package/dist/dynamic-relations.d.ts +2 -2
  163. package/dist/dynamic-relations.js +1 -1
  164. package/dist/dynamic-row-actions.d.ts +1 -1
  165. package/dist/dynamic-row-actions.js +5 -5
  166. package/dist/dynamic-select-field.d.ts +3 -3
  167. package/dist/dynamic-select-field.js +11 -11
  168. package/dist/dynamic-table.d.ts +2 -2
  169. package/dist/dynamic-table.js +24 -24
  170. package/dist/dynamic-view.d.ts +4 -4
  171. package/dist/dynamic-view.js +7 -7
  172. package/dist/entity-select.js +4 -4
  173. package/dist/field-validation-ui.d.ts +2 -2
  174. package/dist/field-widget-registry.d.ts +1 -1
  175. package/dist/form-layout-ui.d.ts +1 -1
  176. package/dist/form-layout.d.ts +1 -1
  177. package/dist/form-layout.js +1 -1
  178. package/dist/genui/index.d.ts +1 -1
  179. package/dist/genui/index.js +1 -1
  180. package/dist/genui/settings-block.d.ts +1 -1
  181. package/dist/genui/settings-block.js +3 -3
  182. package/dist/host-api-client.d.ts +28 -1
  183. package/dist/host-api-client.d.ts.map +1 -1
  184. package/dist/host-api-client.js +27 -14
  185. package/dist/host-api.d.ts +23 -1
  186. package/dist/host-api.d.ts.map +1 -1
  187. package/dist/host-api.js +79 -4
  188. package/dist/hotswap-reload-policy.d.ts +1 -1
  189. package/dist/hotswap-reload-policy.js +1 -1
  190. package/dist/icon-picker-field.d.ts +1 -1
  191. package/dist/icon-picker-field.js +3 -3
  192. package/dist/icon-resolvers.d.ts +1 -1
  193. package/dist/icon-resolvers.js +1 -1
  194. package/dist/icon-spec.js +1 -1
  195. package/dist/index.d.ts +165 -165
  196. package/dist/index.d.ts.map +1 -1
  197. package/dist/index.js +148 -148
  198. package/dist/license/index.d.ts +6 -6
  199. package/dist/license/index.js +6 -6
  200. package/dist/license/license-expiry-banner.d.ts +1 -1
  201. package/dist/license/license-expiry-banner.js +3 -3
  202. package/dist/license/license-gate.d.ts +1 -1
  203. package/dist/license/license-gate.js +5 -5
  204. package/dist/license/license-status-badge.d.ts +1 -1
  205. package/dist/license/license-status-badge.js +1 -1
  206. package/dist/license/use-license-t.d.ts +1 -1
  207. package/dist/license/use-license-t.js +1 -1
  208. package/dist/license/view.d.ts +1 -1
  209. package/dist/license/view.js +1 -1
  210. package/dist/list-include.d.ts +1 -1
  211. package/dist/manifest-hotswap-subscriber.d.ts +1 -1
  212. package/dist/manifest-hotswap-subscriber.js +1 -1
  213. package/dist/metadata-cache.d.ts +1 -1
  214. package/dist/metadata-cache.js +1 -1
  215. package/dist/model-action-toolbar.d.ts +1 -1
  216. package/dist/model-action-toolbar.js +7 -7
  217. package/dist/nav-permissions.d.ts +1 -1
  218. package/dist/nav-permissions.js +1 -1
  219. package/dist/navigation-builder.d.ts +1 -1
  220. package/dist/navigation-builder.js +1 -1
  221. package/dist/option-display.d.ts +1 -1
  222. package/dist/option-display.js +2 -2
  223. package/dist/option-filter.d.ts +1 -1
  224. package/dist/option-when.d.ts +1 -1
  225. package/dist/org-runtime-provider.d.ts +2 -2
  226. package/dist/org-runtime-provider.js +2 -2
  227. package/dist/permissions-context.d.ts +1 -1
  228. package/dist/permissions-manager.js +4 -4
  229. package/dist/primitives/aging.js +1 -1
  230. package/dist/primitives/allocation.js +1 -1
  231. package/dist/primitives/approvals.d.ts +1 -1
  232. package/dist/primitives/contributions.js +1 -1
  233. package/dist/primitives/document-kinds.d.ts +1 -1
  234. package/dist/primitives/index.d.ts +7 -7
  235. package/dist/primitives/index.js +7 -7
  236. package/dist/primitives/panels.d.ts +1 -1
  237. package/dist/primitives/use-contributions.d.ts +2 -2
  238. package/dist/primitives/use-contributions.js +2 -2
  239. package/dist/print-document-button.d.ts +1 -1
  240. package/dist/print-document-button.js +1 -1
  241. package/dist/provenance.js +3 -3
  242. package/dist/query-batch.d.ts +1 -1
  243. package/dist/query-batch.js +1 -1
  244. package/dist/record-actions.d.ts +2 -2
  245. package/dist/record-actions.js +2 -2
  246. package/dist/record-history.d.ts +2 -2
  247. package/dist/record-history.js +3 -3
  248. package/dist/record-picker-dialog.js +3 -3
  249. package/dist/record-picker-option.d.ts +1 -1
  250. package/dist/record-picker-option.js +1 -1
  251. package/dist/record-picker.d.ts +5 -0
  252. package/dist/record-picker.d.ts.map +1 -1
  253. package/dist/record-picker.js +16 -6
  254. package/dist/record-prefill-bar.js +1 -1
  255. package/dist/relation-gallery.js +1 -1
  256. package/dist/requires-addon.d.ts +1 -1
  257. package/dist/rich-cells.js +2 -2
  258. package/dist/rich-url.js +1 -1
  259. package/dist/row-actions-menu.js +5 -5
  260. package/dist/searchable-select-field.d.ts +33 -0
  261. package/dist/searchable-select-field.d.ts.map +1 -0
  262. package/dist/searchable-select-field.js +50 -0
  263. package/dist/searchable-select.d.ts +45 -0
  264. package/dist/searchable-select.d.ts.map +1 -0
  265. package/dist/searchable-select.js +72 -0
  266. package/dist/server-error.js +2 -2
  267. package/dist/setup/addon-config-surface.d.ts +3 -3
  268. package/dist/setup/addon-config-surface.js +10 -10
  269. package/dist/setup/connector-blocks-model.d.ts +1 -1
  270. package/dist/setup/connector-blocks.d.ts +1 -1
  271. package/dist/setup/connector-blocks.js +6 -6
  272. package/dist/setup/flow-model.d.ts +1 -1
  273. package/dist/setup/health-card.d.ts +1 -1
  274. package/dist/setup/health-card.js +2 -2
  275. package/dist/setup/index.d.ts +12 -12
  276. package/dist/setup/index.js +12 -12
  277. package/dist/setup/records-table.d.ts +1 -1
  278. package/dist/setup/records-table.js +2 -2
  279. package/dist/setup/setup-flow.d.ts +1 -1
  280. package/dist/setup/setup-flow.js +7 -7
  281. package/dist/setup/setup-form-step.d.ts +1 -1
  282. package/dist/setup/setup-form-step.js +4 -4
  283. package/dist/setup/step-status-badge.d.ts +1 -1
  284. package/dist/setup/step-status-badge.js +2 -2
  285. package/dist/setup/tone.d.ts +1 -1
  286. package/dist/setup/types.d.ts +2 -2
  287. package/dist/sidebar-layout-manager.d.ts +1 -1
  288. package/dist/sidebar-layout-manager.js +2 -2
  289. package/dist/slot.js +1 -1
  290. package/dist/slots/addon-slot.js +4 -4
  291. package/dist/slots/index.d.ts +2 -2
  292. package/dist/slots/index.js +2 -2
  293. package/dist/stage-automations.d.ts +2 -2
  294. package/dist/stage-automations.js +1 -1
  295. package/dist/stage-layout.js +1 -1
  296. package/dist/stage-overrides.d.ts +1 -1
  297. package/dist/stage-overrides.js +1 -1
  298. package/dist/supervised-action.js +1 -1
  299. package/dist/testing.d.ts +1 -1
  300. package/dist/testing.js +1 -1
  301. package/dist/tri-state-boolean.d.ts +2 -2
  302. package/dist/tri-state-boolean.js +1 -1
  303. package/dist/types.d.ts +13 -1
  304. package/dist/types.d.ts.map +1 -1
  305. package/dist/upload-field.d.ts +1 -1
  306. package/dist/upload-field.js +4 -4
  307. package/dist/use-addon-installed-probe.js +3 -3
  308. package/dist/use-addon-settings.d.ts +1 -1
  309. package/dist/use-addon-settings.js +1 -1
  310. package/dist/use-dynamic-filters.d.ts +2 -2
  311. package/dist/use-dynamic-filters.js +6 -6
  312. package/dist/use-edge-device.d.ts +1 -1
  313. package/dist/use-edge-device.js +2 -2
  314. package/dist/use-facet-loaders.d.ts +1 -1
  315. package/dist/use-facet-loaders.js +1 -1
  316. package/dist/use-flip-animation.d.ts +1 -1
  317. package/dist/use-flip-animation.js +1 -1
  318. package/dist/use-host-api-client.d.ts +2 -2
  319. package/dist/use-host-api-client.d.ts.map +1 -1
  320. package/dist/use-host-api-client.js +6 -4
  321. package/dist/use-option-ids.d.ts +1 -1
  322. package/dist/use-option-ids.js +2 -2
  323. package/dist/use-options-resolver.d.ts +2 -2
  324. package/dist/use-options-resolver.js +4 -4
  325. package/dist/use-org-document-templates.js +1 -1
  326. package/dist/use-print-document.js +1 -1
  327. package/dist/use-record-mutation-tick.js +1 -1
  328. package/dist/validator.d.ts +2 -2
  329. package/dist/validator.js +1 -1
  330. package/dist/view-system/card-spec.d.ts +1 -1
  331. package/dist/view-system/cards-view.d.ts +1 -1
  332. package/dist/view-system/cards-view.js +2 -2
  333. package/dist/view-system/index.d.ts +9 -9
  334. package/dist/view-system/index.js +9 -9
  335. package/dist/view-system/model-view.d.ts +3 -3
  336. package/dist/view-system/model-view.js +7 -7
  337. package/dist/view-system/saved-views.d.ts +1 -1
  338. package/dist/view-system/use-view-mode.d.ts +1 -1
  339. package/dist/view-system/view-state.d.ts +1 -1
  340. package/dist/view-system/view-switcher.d.ts +1 -1
  341. package/dist/view-system/view-toolbar.d.ts +1 -1
  342. package/dist/view-system/view-toolbar.js +2 -2
  343. package/dist/views/calendar-view.d.ts +1 -1
  344. package/dist/views/calendar-view.js +2 -2
  345. package/dist/views/chart-view.d.ts +2 -2
  346. package/dist/views/chart-view.js +2 -2
  347. package/dist/views/data-source.d.ts +2 -2
  348. package/dist/views/index.d.ts +3 -3
  349. package/dist/views/index.js +2 -2
  350. package/dist/views/map-view.d.ts +1 -1
  351. package/dist/views/map-view.js +3 -3
  352. package/dist/views/panels.d.ts +1 -1
  353. package/dist/views/panels.js +3 -3
  354. package/dist/views/registry.d.ts +2 -2
  355. package/dist/views/registry.js +12 -12
  356. package/dist/views/split-view.d.ts +1 -1
  357. package/dist/views/split-view.js +4 -4
  358. package/dist/views/timeline-view.d.ts +1 -1
  359. package/dist/views/timeline-view.js +3 -3
  360. package/dist/views/types.d.ts +2 -2
  361. package/dist/widgets/charts.d.ts +1 -1
  362. package/dist/widgets/charts.js +2 -2
  363. package/dist/widgets/lazy-charts.d.ts +1 -1
  364. package/dist/widgets/lazy-charts.js +2 -2
  365. package/dist/widgets/renderers.d.ts +2 -2
  366. package/dist/widgets/renderers.js +2 -2
  367. package/dist/widgets/widget-card.d.ts +1 -1
  368. package/dist/widgets/widget-card.js +2 -2
  369. package/dist/widgets/widget-renderer.d.ts +1 -1
  370. package/dist/widgets/widget-renderer.js +4 -4
  371. package/package.json +9 -9
  372. package/src/__tests__/host-api-client.test.tsx +28 -0
  373. package/src/__tests__/host-api.test.ts +91 -0
  374. package/src/__tests__/searchable-select.test.tsx +247 -0
  375. package/src/action-modal-dispatcher.tsx +16 -0
  376. package/src/dialogs/dynamic-record.tsx +26 -0
  377. package/src/dynamic-form.tsx +17 -0
  378. package/src/dynamic-line-items.tsx +17 -0
  379. package/src/dynamic-multi-select-field.tsx +5 -4
  380. package/src/host-api-client.ts +51 -15
  381. package/src/host-api.ts +81 -3
  382. package/src/index.ts +2 -1
  383. package/src/record-picker.tsx +32 -3
  384. package/src/searchable-select-field.tsx +134 -0
  385. package/src/searchable-select.ts +87 -0
  386. package/src/types.ts +12 -0
  387. package/src/use-host-api-client.ts +5 -3
@@ -0,0 +1,247 @@
1
+ // @vitest-environment happy-dom
2
+ //
3
+ // Searchable select: a STATIC `select` with many options (or `searchable: true`)
4
+ // renders a combobox with a search box instead of a flat dropdown.
5
+ // - pure rules: threshold, accent/case-insensitive filter by label, code and
6
+ // description, ranking, windowing;
7
+ // - the component: filters while typing, highlights, "Sin resultados",
8
+ // keyboard (arrows / Enter / Esc), selection mark, clear when optional;
9
+ // - wiring: EditField (DynamicRecordDialog) and DynamicForm choose combobox vs
10
+ // flat select by option count and `searchable`.
11
+ import { useState } from 'react'
12
+ import { afterEach, describe, expect, it, vi } from 'vitest'
13
+ import { cleanup, fireEvent, render, screen, within } from '@testing-library/react'
14
+
15
+ vi.mock('react-i18next', () => {
16
+ const t = (k: string, o?: Record<string, any>) => o?.defaultValue ?? k
17
+ const value = { t, i18n: { language: 'es' } }
18
+ return { useTranslation: () => value }
19
+ })
20
+
21
+ import {
22
+ SEARCHABLE_SELECT_THRESHOLD,
23
+ filterSearchableOptions,
24
+ isSearchableSelect,
25
+ windowOptions,
26
+ } from '../searchable-select'
27
+ import { SearchableSelectField } from '../searchable-select-field'
28
+ import { EditField } from '../dialogs/dynamic-record'
29
+ import { DynamicForm } from '../dynamic-form'
30
+
31
+ afterEach(cleanup)
32
+
33
+ const REGIMENES = [
34
+ ['601', 'General de Ley Personas Morales'],
35
+ ['603', 'Personas Morales con Fines no Lucrativos'],
36
+ ['605', 'Sueldos y Salarios e Ingresos Asimilados a Salarios'],
37
+ ['606', 'Arrendamiento'],
38
+ ['607', 'Régimen de Enajenación o Adquisición de Bienes'],
39
+ ['608', 'Demás ingresos'],
40
+ ['610', 'Residentes en el Extranjero sin Establecimiento Permanente en México'],
41
+ ['611', 'Ingresos por Dividendos (socios y accionistas)'],
42
+ ['612', 'Personas Físicas con Actividades Empresariales y Profesionales'],
43
+ ['614', 'Ingresos por intereses'],
44
+ ['615', 'Régimen de los ingresos por obtención de premios'],
45
+ ['616', 'Sin obligaciones fiscales'],
46
+ ['620', 'Sociedades Cooperativas de Producción que optan por diferir sus ingresos'],
47
+ ['621', 'Incorporación Fiscal'],
48
+ ['622', 'Actividades Agrícolas, Ganaderas, Silvícolas y Pesqueras'],
49
+ ['623', 'Opcional para Grupos de Sociedades'],
50
+ ['624', 'Coordinados'],
51
+ ['625', 'Actividades Empresariales con ingresos a través de Plataformas Tecnológicas'],
52
+ ['626', 'Régimen Simplificado de Confianza'],
53
+ ['628', 'Hidrocarburos'],
54
+ ['629', 'De los Regímenes Fiscales Preferentes y de las Empresas Multinacionales'],
55
+ ['630', 'Enajenación de acciones en bolsa de valores'],
56
+ ].map(([value, label]) => ({ value, label: `${value} - ${label}` }))
57
+
58
+ describe('isSearchableSelect (umbral)', () => {
59
+ it('por defecto solo por encima de 8 opciones', () => {
60
+ expect(SEARCHABLE_SELECT_THRESHOLD).toBe(8)
61
+ expect(isSearchableSelect({}, 8)).toBe(false)
62
+ expect(isSearchableSelect({}, 9)).toBe(true)
63
+ expect(isSearchableSelect(undefined, 3)).toBe(false)
64
+ })
65
+ it('searchable explícito gana en ambos sentidos', () => {
66
+ expect(isSearchableSelect({ searchable: true }, 2)).toBe(true)
67
+ expect(isSearchableSelect({ searchable: false }, 500)).toBe(false)
68
+ })
69
+ it('searchThreshold por campo; valores inválidos caen al default', () => {
70
+ expect(isSearchableSelect({ searchThreshold: 3 }, 4)).toBe(true)
71
+ expect(isSearchableSelect({ searchThreshold: 30 }, 25)).toBe(false)
72
+ expect(isSearchableSelect({ searchThreshold: -1 }, 5)).toBe(false)
73
+ expect(isSearchableSelect({ searchThreshold: Number.NaN }, 9)).toBe(true)
74
+ })
75
+ })
76
+
77
+ describe('filterSearchableOptions', () => {
78
+ it('encuentra por código, palabra y sin acentos', () => {
79
+ expect(filterSearchableOptions(REGIMENES, '630').map((o) => o.value)).toEqual(['630'])
80
+ expect(filterSearchableOptions(REGIMENES, 'BOLSA').map((o) => o.value)).toEqual(['630'])
81
+ expect(filterSearchableOptions(REGIMENES, 'enajenacion').map((o) => o.value)).toEqual(['607', '630'])
82
+ expect(filterSearchableOptions(REGIMENES, 'regimen simplificado').map((o) => o.value)).toEqual(['626'])
83
+ })
84
+ it('busca también en description', () => {
85
+ const opts = [
86
+ { value: 'a', label: 'Alpha', description: 'primer elemento' },
87
+ { value: 'b', label: 'Beta', description: 'segundo' },
88
+ ]
89
+ expect(filterSearchableOptions(opts, 'SEGUNDO').map((o) => o.value)).toEqual(['b'])
90
+ })
91
+ it('sin resultados devuelve vacío; query vacía no filtra ni muta', () => {
92
+ expect(filterSearchableOptions(REGIMENES, 'zzzz')).toEqual([])
93
+ const all = filterSearchableOptions(REGIMENES, ' ')
94
+ expect(all).toHaveLength(REGIMENES.length)
95
+ expect(all).not.toBe(REGIMENES)
96
+ })
97
+ it('ordena: empieza con la consulta antes que contiene', () => {
98
+ const opts = [
99
+ { value: '1', label: 'Fiscal general' },
100
+ { value: '2', label: 'General de ley' },
101
+ { value: '3', label: 'Regimen general' },
102
+ ]
103
+ expect(filterSearchableOptions(opts, 'general').map((o) => o.value)).toEqual(['2', '1', '3'])
104
+ })
105
+ })
106
+
107
+ describe('windowOptions', () => {
108
+ it('no recorta bajo el tope; recorta y conserva la opción seleccionada', () => {
109
+ const rows = Array.from({ length: 300 }, (_, i) => i)
110
+ expect(windowOptions(rows.slice(0, 50), 100, () => false)).toEqual({ rows: rows.slice(0, 50), hidden: 0 })
111
+ const w = windowOptions(rows, 100, (n) => n === 250)
112
+ expect(w.rows).toHaveLength(101)
113
+ expect(w.rows).toContain(250)
114
+ expect(w.hidden).toBe(199)
115
+ })
116
+ })
117
+
118
+ function Harness({ required = false, initial = '' }: { required?: boolean; initial?: string }) {
119
+ const [v, setV] = useState(initial)
120
+ return (
121
+ <>
122
+ <SearchableSelectField
123
+ id="regimen"
124
+ ariaLabel="Régimen fiscal"
125
+ options={REGIMENES}
126
+ value={v}
127
+ onChange={setV}
128
+ required={required}
129
+ />
130
+ <output data-testid="value">{v}</output>
131
+ </>
132
+ )
133
+ }
134
+
135
+ const open = () => fireEvent.click(screen.getByRole('combobox', { name: 'Régimen fiscal' }))
136
+ const search = () => screen.getAllByRole('combobox').find((el) => el.tagName === 'INPUT') as HTMLInputElement
137
+ const type = (text: string) => fireEvent.change(search(), { target: { value: text } })
138
+
139
+ describe('SearchableSelectField', () => {
140
+ it('abre con buscador, filtra por código y por palabra sin acentos, y resalta', () => {
141
+ render(<Harness />)
142
+ open()
143
+ expect(screen.getAllByRole('option').length).toBe(REGIMENES.length)
144
+ type('630')
145
+ const opts = screen.getAllByRole('option')
146
+ expect(opts).toHaveLength(1)
147
+ expect(opts[0]!.textContent).toContain('Enajenación de acciones en bolsa de valores')
148
+ expect(opts[0]!.querySelector('mark')?.textContent).toBe('630')
149
+ type('bolsa')
150
+ expect(screen.getAllByRole('option')).toHaveLength(1)
151
+ expect(screen.getByRole('option').querySelector('mark')?.textContent).toBe('bolsa')
152
+ type('ENAJENACION')
153
+ expect(screen.getAllByRole('option')).toHaveLength(2)
154
+ expect(screen.getAllByRole('option')[1]!.querySelector('mark')?.textContent).toBe('Enajenación')
155
+ })
156
+
157
+ it('muestra "Sin resultados" cuando nada coincide', () => {
158
+ render(<Harness />)
159
+ open()
160
+ type('qwerty')
161
+ expect(screen.queryAllByRole('option')).toHaveLength(0)
162
+ expect(screen.getByText('Sin resultados')).toBeTruthy()
163
+ })
164
+
165
+ it('teclado: flechas + Enter eligen, Esc cierra, ARIA listbox/combobox', () => {
166
+ render(<Harness />)
167
+ open()
168
+ const input = search()
169
+ expect(input.getAttribute('aria-autocomplete')).toBe('list')
170
+ expect(screen.getByRole('listbox', { name: 'Régimen fiscal' })).toBeTruthy()
171
+ type('ingresos')
172
+ fireEvent.keyDown(input, { key: 'ArrowDown' })
173
+ const active = input.getAttribute('aria-activedescendant')
174
+ expect(active).toBeTruthy()
175
+ expect(document.getElementById(active!)?.getAttribute('data-active')).toBe('true')
176
+ fireEvent.keyDown(input, { key: 'Enter' })
177
+ expect(screen.getByTestId('value').textContent).not.toBe('')
178
+ expect(screen.queryByRole('listbox')).toBeNull()
179
+ })
180
+
181
+ it('elegir marca la opción y reabrir la deja seleccionada y activa', () => {
182
+ render(<Harness initial="626" />)
183
+ const trigger = screen.getByRole('combobox', { name: 'Régimen fiscal' })
184
+ expect(trigger.textContent).toContain('626 - Régimen Simplificado de Confianza')
185
+ fireEvent.click(trigger)
186
+ const sel = screen.getAllByRole('option').find((o) => o.getAttribute('data-selected') === 'true')
187
+ expect(sel?.textContent).toContain('626')
188
+ expect(sel?.getAttribute('data-active')).toBe('true')
189
+ })
190
+
191
+ it('limpiar solo cuando no es requerido', () => {
192
+ const { unmount } = render(<Harness initial="601" />)
193
+ fireEvent.click(screen.getByLabelText('Quitar selección'))
194
+ expect(screen.getByTestId('value').textContent).toBe('')
195
+ unmount()
196
+ render(<Harness initial="601" required />)
197
+ expect(screen.queryByLabelText('Quitar selección')).toBeNull()
198
+ })
199
+
200
+ it('lista enorme: se ventanea y avisa cuántas hay', () => {
201
+ const big = Array.from({ length: 400 }, (_, i) => ({ value: `v${i}`, label: `Opción ${i}` }))
202
+ render(<SearchableSelectField options={big} value="v399" onChange={() => {}} ariaLabel="Grande" />)
203
+ fireEvent.click(screen.getByRole('combobox', { name: 'Grande' }))
204
+ expect(screen.getAllByRole('option')).toHaveLength(101)
205
+ expect(screen.getByText(/Mostrando 101 de 400/)).toBeTruthy()
206
+ expect(screen.getAllByRole('option').some((o) => o.getAttribute('data-selected') === 'true')).toBe(true)
207
+ })
208
+ })
209
+
210
+ describe('cableado por umbral', () => {
211
+ const opts = (n: number) => Array.from({ length: n }, (_, i) => ({ value: `v${i}`, label: `Opción ${i}` }))
212
+
213
+ it('EditField: 25 opciones => combobox con buscador', () => {
214
+ render(<EditField field={{ key: 'regimen', label: 'Régimen fiscal', type: 'select', options: REGIMENES }} value="" onChange={() => {}} />)
215
+ fireEvent.click(screen.getByRole('combobox'))
216
+ expect(search()).toBeTruthy()
217
+ })
218
+
219
+ it('EditField: pocas opciones => select plano (sin buscador)', () => {
220
+ render(<EditField field={{ key: 'k', label: 'K', type: 'select', options: opts(5) }} value="" onChange={() => {}} />)
221
+ const trigger = screen.getByRole('combobox')
222
+ expect(trigger.getAttribute('aria-haspopup')).not.toBe('listbox') // Radix Select, no RecordPicker
223
+ expect(trigger.closest('[data-slot="searchable-select"]')).toBeNull()
224
+ })
225
+
226
+ it('EditField: searchable true fuerza el buscador con pocas; false lo quita con muchas', () => {
227
+ const { unmount } = render(
228
+ <EditField field={{ key: 'k', label: 'K', type: 'select', options: opts(3), searchable: true }} value="" onChange={() => {}} />,
229
+ )
230
+ expect(document.querySelector('[data-slot="searchable-select"]')).toBeTruthy()
231
+ unmount()
232
+ render(<EditField field={{ key: 'k', label: 'K', type: 'select', options: opts(40), searchable: false }} value="" onChange={() => {}} />)
233
+ expect(document.querySelector('[data-slot="searchable-select"]')).toBeNull()
234
+ })
235
+
236
+ it('DynamicForm: el campo select largo usa el combobox', () => {
237
+ render(
238
+ <DynamicForm
239
+ fields={[{ key: 'regimen', label: 'Régimen fiscal', type: 'select', options: REGIMENES }]}
240
+ onSubmit={() => {}}
241
+ />,
242
+ )
243
+ const scope = within(document.body)
244
+ expect(scope.getByRole('combobox', { name: 'Régimen fiscal' })).toBeTruthy()
245
+ expect(document.querySelector('[data-slot="searchable-select"]')).toBeTruthy()
246
+ })
247
+ })
@@ -67,6 +67,8 @@ import { DynamicIcon } from './dynamic-icon'
67
67
  import { DynamicLineItems } from './dynamic-line-items'
68
68
  import { DynamicRelations } from './dynamic-relations'
69
69
  import { DynamicSelectField } from './dynamic-select-field'
70
+ import { SearchableSelectField } from './searchable-select-field'
71
+ import { isSearchableSelect } from './searchable-select'
70
72
  import { DynamicDateField } from './dynamic-date-field'
71
73
  import { UploadField } from './upload-field'
72
74
  import { isLineItemsField, resolveWidget, resolveDependsValue, getDependsOn, getFieldRef, applyOptionWhen } from './dynamic-form-schema'
@@ -1884,6 +1886,20 @@ export function renderField(
1884
1886
  const stale = !!value && !options.some((o) => String(o.value) === String(value))
1885
1887
  const selectInvalid = invalid || stale
1886
1888
  const selectCls = selectInvalid ? 'border-destructive ring-1 ring-destructive/30 focus-visible:ring-destructive' : ''
1889
+ if (isSearchableSelect(field, options.length)) {
1890
+ return (
1891
+ <SearchableSelectField
1892
+ id={field.key}
1893
+ ariaLabel={field.label || field.key}
1894
+ options={options}
1895
+ value={stale ? '' : value}
1896
+ onChange={onChange}
1897
+ placeholder={field.placeholder || undefined}
1898
+ required={!!field.required}
1899
+ invalid={selectInvalid}
1900
+ />
1901
+ )
1902
+ }
1887
1903
  return (
1888
1904
  <Select value={stale ? '' : value || ''} onValueChange={onChange}>
1889
1905
  <SelectTrigger className={'w-full' + (selectCls ? ` ${selectCls}` : '')} aria-invalid={selectInvalid || undefined} data-stale-option={stale || undefined}><SelectValue placeholder={field.placeholder || 'Seleccionar...'} /></SelectTrigger>
@@ -54,6 +54,8 @@ import { useBranchCreateGate } from '../branch-create-gate'
54
54
  import { toastServerError, extractFieldErrors, localizeFieldIssue, localizeFieldErrorMap } from '../server-error'
55
55
  import { DynamicSelectField, OptionLead, OptionThumb } from '../dynamic-select-field'
56
56
  import { RecordPicker } from '../record-picker'
57
+ import { SearchableSelectField } from '../searchable-select-field'
58
+ import { isSearchableSelect } from '../searchable-select'
57
59
  import { DynamicMultiSelectField } from '../dynamic-multi-select-field'
58
60
  import { UploadField, validateUploadFile } from '../upload-field'
59
61
  import { DynamicRelations } from '../dynamic-relations'
@@ -117,6 +119,8 @@ export interface FieldOption {
117
119
  color?: string
118
120
  icon?: string
119
121
  image?: string
122
+ /** Secondary text; also matched by the searchable select search box. */
123
+ description?: string
120
124
  }
121
125
 
122
126
  export interface FieldDef {
@@ -131,6 +135,14 @@ export interface FieldDef {
131
135
  */
132
136
  nullable?: boolean
133
137
  options?: FieldOption[]
138
+ /**
139
+ * Searchable select: `true` always renders the combobox with a search box,
140
+ * `false` always the flat select, unset = combobox when the field has more
141
+ * than SEARCHABLE_SELECT_THRESHOLD (8) options. Served by the kernel as
142
+ * `searchable`. `searchThreshold` overrides the 8.
143
+ */
144
+ searchable?: boolean
145
+ searchThreshold?: number
134
146
  defaultValue?: any
135
147
  placeholder?: string
136
148
  readonly?: boolean
@@ -2587,6 +2599,20 @@ export function EditField({ field, value, onChange, record, invalid, error, labe
2587
2599
  }
2588
2600
 
2589
2601
  if (field.type === 'select' && field.options?.length) {
2602
+ // Long static list (or `searchable: true`): combobox with a search box.
2603
+ if (isSearchableSelect(field, field.options.length)) {
2604
+ return (
2605
+ <SearchableSelectField
2606
+ id={field.key}
2607
+ ariaLabel={field.label || field.key}
2608
+ options={field.options}
2609
+ value={value}
2610
+ onChange={onChange}
2611
+ required={!!field.required}
2612
+ invalid={invalid}
2613
+ />
2614
+ )
2615
+ }
2590
2616
  return (
2591
2617
  <Select value={String(value ?? '')} onValueChange={onChange}>
2592
2618
  <SelectTrigger className={cn("w-full", invalidCls)} aria-invalid={invalid || undefined}>
@@ -34,6 +34,8 @@ import { getOptionFilter } from './option-filter'
34
34
  import { useOptionsResolver, type ResolvedOption } from './use-options-resolver'
35
35
  import { DynamicLineItems } from './dynamic-line-items'
36
36
  import { DynamicSelectField } from './dynamic-select-field'
37
+ import { SearchableSelectField } from './searchable-select-field'
38
+ import { isSearchableSelect } from './searchable-select'
37
39
  import { DynamicMultiSelectField } from './dynamic-multi-select-field'
38
40
  import { DynamicDateField } from './dynamic-date-field'
39
41
  import { UploadField } from './upload-field'
@@ -538,6 +540,21 @@ function FieldRenderer({
538
540
  )
539
541
  case 'select': {
540
542
  const opts = effectiveOptions ?? field.options
543
+ // Long static list (or `searchable: true`): combobox with a search box
544
+ // instead of a flat dropdown the user has to scroll.
545
+ if (isSearchableSelect(field, opts?.length ?? 0)) {
546
+ return (
547
+ <SearchableSelectField
548
+ id={field.key}
549
+ ariaLabel={field.label || field.key}
550
+ options={opts ?? []}
551
+ value={value}
552
+ onChange={onChange}
553
+ placeholder={field.placeholder || undefined}
554
+ required={!!field.required}
555
+ />
556
+ )
557
+ }
541
558
  return (
542
559
  <Select value={value || ''} onValueChange={guardEmptySelect(value, onChange, (opts ?? []).map((o) => o.value))}>
543
560
  <SelectTrigger className="w-full"><SelectValue placeholder={field.placeholder || 'Seleccionar...'} /></SelectTrigger>
@@ -38,6 +38,8 @@ import {
38
38
  applyOptionWhen,
39
39
  } from './dynamic-form-schema'
40
40
  import { DynamicSelectField, DEFAULT_DEPENDS_HINT } from './dynamic-select-field'
41
+ import { SearchableSelectField } from './searchable-select-field'
42
+ import { isSearchableSelect } from './searchable-select'
41
43
  import { getOptionFilter } from './option-filter'
42
44
  import { useOptionsResolver, type ResolvedOption } from './use-options-resolver'
43
45
 
@@ -503,6 +505,21 @@ function CellRenderer({ field, value, onChange, onPick, disabled, formValues, ro
503
505
  const opts = effectiveOptions ?? field.options
504
506
  // No option applies under the current sibling value → hide the cell.
505
507
  if (effectiveOptions && effectiveOptions.length === 0) return null
508
+ if (isSearchableSelect(field, opts?.length ?? 0)) {
509
+ return (
510
+ <SearchableSelectField
511
+ id={field.key}
512
+ ariaLabel={field.label || field.key}
513
+ options={opts ?? []}
514
+ value={value}
515
+ onChange={onChange}
516
+ placeholder={field.placeholder || undefined}
517
+ required={!!field.required}
518
+ disabled={off}
519
+ invalid={invalid}
520
+ />
521
+ )
522
+ }
506
523
  return (
507
524
  <Select value={value || ''} onValueChange={onChange} disabled={off}>
508
525
  <SelectTrigger className={'w-full' + (invalidCls ? ` ${invalidCls}` : '')} aria-invalid={invalid || undefined}>
@@ -22,6 +22,7 @@
22
22
  // with ONE `?ids=` lookup (useResolveOptionIds): a chip reads "Cargando…" while
23
23
  // it resolves and "(registro eliminado)" when the record is gone — never the id.
24
24
  import { useMemo, useState } from 'react'
25
+ import { filterSearchableOptions } from './searchable-select'
25
26
  import { getOptionFilter } from './option-filter'
26
27
  import { RecordPicker } from './record-picker'
27
28
  import { OptionLead } from './record-picker-option'
@@ -89,10 +90,9 @@ export function DynamicMultiSelectField({ field, value, onChange, staticOptions
89
90
  const label = useStatic ? id : !r ? 'Cargando…' : r.status === 'missing' ? DELETED_RECORD_LABEL : id
90
91
  return { id, value: id, label, name: label }
91
92
  })
92
- const shown = useMemo(() => {
93
- const q = query.trim().toLowerCase()
94
- return q ? options.filter((o) => String(o.label ?? '').toLowerCase().includes(q)) : options
95
- }, [options, query])
93
+ // Case/accent-insensitive, by label, code and description (shared with the
94
+ // single searchable select); order kept inside each relevance rank.
95
+ const shown = useMemo(() => filterSearchableOptions(options, query), [options, query])
96
96
 
97
97
  const toggle = (o: ResolvedOption) => {
98
98
  const id = String(o.id)
@@ -110,6 +110,7 @@ export function DynamicMultiSelectField({ field, value, onChange, staticOptions
110
110
  getLabel={(o) => o.label}
111
111
  renderLead={(o) => <OptionLead option={o} size={20} />}
112
112
  getDescription={(o) => o.description}
113
+ highlightQuery
113
114
  value={selected}
114
115
  selected={selectedItems}
115
116
  onSelect={toggle}
@@ -22,6 +22,32 @@ export { ApiError, isAbortError }
22
22
  export interface HostRequestConfig {
23
23
  params?: HostApiParams
24
24
  signal?: AbortSignal
25
+ /**
26
+ * Extra headers for this call (e.g. `X-Correlation-ID`), merged over the
27
+ * client's `defaultHeaders`. The host drops Authorization, X-Organization-ID
28
+ * and the other headers it owns; they can never be overridden from here.
29
+ */
30
+ headers?: Record<string, string>
31
+ /**
32
+ * Per-call timeout (ms) for slow operations; overrides `defaultTimeout`.
33
+ * Finite number >= 0, else ignored. The host clamps it to its ceiling, so
34
+ * `0` means that ceiling (never unlimited unless the host allows it).
35
+ * A timeout rejects the call but the server may still have applied it.
36
+ */
37
+ timeout?: number
38
+ /**
39
+ * `'network'`: never serve this read from the host's offline cache (use for
40
+ * money-critical reads). Rejects on network failure. Enforced only by hosts
41
+ * that honor it (ops does not yet unless it reads `metacoreFreshness`).
42
+ */
43
+ freshness?: 'network'
44
+ }
45
+
46
+ export interface HostApiClientOptions {
47
+ /** Headers sent on every call; per-call `headers` win over them. */
48
+ defaultHeaders?: Record<string, string>
49
+ /** Timeout (ms) for every call; a per-call `timeout` wins. */
50
+ defaultTimeout?: number
25
51
  }
26
52
 
27
53
  /** Minimal axios-like surface (what DynamicSelectField & co. call). */
@@ -53,7 +79,7 @@ export interface HostApiClient {
53
79
  path: string,
54
80
  file: File | Blob | FormData,
55
81
  fields?: Record<string, string>,
56
- opts?: { fileField?: string; signal?: AbortSignal },
82
+ opts?: { fileField?: string; signal?: AbortSignal; timeout?: number; headers?: Record<string, string> },
57
83
  ): Promise<T>
58
84
  /**
59
85
  * Axios-like adapter for runtime-react fields that expect `{ data }` with
@@ -83,7 +109,17 @@ function toApiError(e: unknown, signal?: AbortSignal): Error {
83
109
  }
84
110
 
85
111
  /** Build the client over the host-injected {@link HostApi}. */
86
- export function createHostApiClient(api: HostApi): HostApiClient {
112
+ export function createHostApiClient(api: HostApi, options: HostApiClientOptions = {}): HostApiClient {
113
+ const defaults = options.defaultHeaders
114
+ const defaultTimeout = options.defaultTimeout
115
+ // Additive: without defaults or per-call options the config is untouched.
116
+ const cfg = <C extends HostRequestConfig | undefined>(c: C): C => {
117
+ if (!defaults && defaultTimeout === undefined) return c
118
+ const out: HostRequestConfig = { ...(c ?? {}) }
119
+ if (defaults) out.headers = { ...defaults, ...(c?.headers ?? {}) }
120
+ if (defaultTimeout !== undefined && c?.timeout === undefined) out.timeout = defaultTimeout
121
+ return out as C
122
+ }
87
123
  const run = async <R,>(p: () => Promise<R>, signal?: AbortSignal): Promise<R> => {
88
124
  try {
89
125
  return await p()
@@ -95,15 +131,15 @@ export function createHostApiClient(api: HostApi): HostApiClient {
95
131
  run(async () => unwrapEnvelope<T>(await p()), signal)
96
132
 
97
133
  const client: HostApiClient = {
98
- get: (path, c) => body(() => api.get(path, c), c?.signal),
99
- post: (path, b, c) => body(() => api.post(path, b, c), c?.signal),
100
- put: (path, b, c) => body(() => api.put(path, b, c), c?.signal),
101
- patch: (path, b, c) => body(() => api.patch(path, b, c), c?.signal),
102
- delete: (path, c) => body(() => api.delete(path, c), c?.signal),
134
+ get: (path, c) => body(() => api.get(path, cfg(c)), c?.signal),
135
+ post: (path, b, c) => body(() => api.post(path, b, cfg(c)), c?.signal),
136
+ put: (path, b, c) => body(() => api.put(path, b, cfg(c)), c?.signal),
137
+ patch: (path, b, c) => body(() => api.patch(path, b, cfg(c)), c?.signal),
138
+ delete: (path, c) => body(() => api.delete(path, cfg(c)), c?.signal),
103
139
  list: (path, c) =>
104
- run(async () => unwrapList(await api.get(path, c)), c?.signal),
140
+ run(async () => unwrapList(await api.get(path, cfg(c))), c?.signal),
105
141
  blob: (path, c) =>
106
- run(() => api.get<Blob>(path, { ...c, responseType: 'blob' }), c?.signal),
142
+ run(() => api.get<Blob>(path, { ...cfg(c), responseType: 'blob' }), c?.signal),
107
143
  upload: (path, file, fields, opts) => {
108
144
  let form: FormData
109
145
  if (typeof FormData !== 'undefined' && file instanceof FormData) {
@@ -113,7 +149,7 @@ export function createHostApiClient(api: HostApi): HostApiClient {
113
149
  form.append(opts?.fileField ?? 'file', file as Blob)
114
150
  for (const [k, v] of Object.entries(fields ?? {})) form.append(k, v)
115
151
  }
116
- return body(() => api.post(path, form, opts?.signal ? { signal: opts.signal } : undefined), opts?.signal)
152
+ return body(() => api.post(path, form, cfg(opts?.signal || opts?.timeout !== undefined || opts?.headers ? { signal: opts.signal, timeout: opts.timeout, headers: opts.headers } : undefined)), opts?.signal)
117
153
  },
118
154
  axiosLike: () => {
119
155
  // Envelope kept (the runtime-react fields unwrap it themselves),
@@ -125,11 +161,11 @@ export function createHostApiClient(api: HostApi): HostApiClient {
125
161
  return { data }
126
162
  }, signal)
127
163
  return {
128
- get: (u, c) => raw(() => api.get(u, c), c?.signal),
129
- post: (u, b, c) => raw(() => api.post(u, b, c), c?.signal),
130
- put: (u, b, c) => raw(() => api.put(u, b, c), c?.signal),
131
- patch: (u, b, c) => raw(() => api.patch(u, b, c), c?.signal),
132
- delete: (u, c) => raw(() => api.delete(u, c), c?.signal),
164
+ get: (u, c) => raw(() => api.get(u, cfg(c)), c?.signal),
165
+ post: (u, b, c) => raw(() => api.post(u, b, cfg(c)), c?.signal),
166
+ put: (u, b, c) => raw(() => api.put(u, b, cfg(c)), c?.signal),
167
+ patch: (u, b, c) => raw(() => api.patch(u, b, cfg(c)), c?.signal),
168
+ delete: (u, c) => raw(() => api.delete(u, cfg(c)), c?.signal),
133
169
  }
134
170
  },
135
171
  }
package/src/host-api.ts CHANGED
@@ -33,6 +33,12 @@ export interface CreateHostApiOptions {
33
33
  * batches.
34
34
  */
35
35
  batchGets?: boolean
36
+ /**
37
+ * Ceiling (ms) for a remote's per-call `timeout`. Default 600000 (10 min).
38
+ * A remote asking for more, or for `0`, gets this ceiling. `0` here means
39
+ * the host admits no ceiling (remote `0` = no limit).
40
+ */
41
+ maxTimeoutMs?: number
36
42
  }
37
43
 
38
44
  type AxiosLikeError = {
@@ -77,12 +83,82 @@ function safeData(data: unknown): unknown {
77
83
  }
78
84
  }
79
85
 
80
- function toConfig(opts?: HostApiRequestOptions): Record<string, unknown> | undefined {
86
+ /**
87
+ * Headers the host owns. A remote may add headers but never set these: they
88
+ * carry the credentials, the tenant scope or transport framing. Compared
89
+ * lowercase.
90
+ */
91
+ export const PROTECTED_HOST_HEADERS: ReadonlySet<string> = new Set([
92
+ 'authorization',
93
+ 'proxy-authorization',
94
+ 'cookie',
95
+ 'x-organization-id',
96
+ 'x-org-id',
97
+ 'x-branch-id',
98
+ 'accept-language',
99
+ 'host',
100
+ 'content-length',
101
+ 'content-type',
102
+ 'transfer-encoding',
103
+ 'origin',
104
+ 'referer',
105
+ // Reenvio / identidad de origen: el backend arma URLs publicas y decide
106
+ // tenant a partir de ellas.
107
+ 'x-forwarded-host',
108
+ 'x-forwarded-proto',
109
+ 'x-forwarded-for',
110
+ 'x-forwarded-port',
111
+ 'forwarded',
112
+ 'x-real-ip',
113
+ 'x-storefront-domain',
114
+ 'x-api-key',
115
+ 'x-http-method-override',
116
+ ])
117
+ const PROTECTED_HEADER_PREFIXES = ['proxy-']
118
+
119
+ /** Drop protected / malformed headers; returns undefined when none remain. */
120
+ export function sanitizeRemoteHeaders(
121
+ headers: Record<string, string> | undefined,
122
+ ): Record<string, string> | undefined {
123
+ if (!headers || typeof headers !== 'object') return undefined
124
+ const out: Record<string, string> = {}
125
+ for (const [name, value] of Object.entries(headers)) {
126
+ if (typeof value !== 'string') continue
127
+ if (!/^[A-Za-z0-9!#$%&'*+.^_`|~-]+$/.test(name)) continue
128
+ if (/[\r\n]/.test(value)) continue
129
+ const lower = name.toLowerCase()
130
+ if (PROTECTED_HOST_HEADERS.has(lower) || PROTECTED_HEADER_PREFIXES.some((p) => lower.startsWith(p))) continue
131
+ out[name] = value
132
+ }
133
+ return Object.keys(out).length ? out : undefined
134
+ }
135
+
136
+ export const DEFAULT_MAX_TIMEOUT_MS = 600_000
137
+
138
+ /** Request-config key the host transport reads to bypass its offline cache. */
139
+ export const HOST_FRESHNESS_KEY = 'metacoreFreshness'
140
+
141
+ /**
142
+ * Validate a requested timeout: finite number >= 0 else `undefined` (ignored);
143
+ * clamp to `max` (0 or above max => max; `max === 0` => no ceiling).
144
+ */
145
+ export function normalizeTimeout(t: unknown, max: number = DEFAULT_MAX_TIMEOUT_MS): number | undefined {
146
+ if (typeof t !== 'number' || !Number.isFinite(t) || t < 0) return undefined
147
+ if (max > 0 && (t === 0 || t > max)) return max
148
+ return t
149
+ }
150
+
151
+ function toConfig(opts?: HostApiRequestOptions, maxTimeoutMs?: number): Record<string, unknown> | undefined {
81
152
  if (!opts) return undefined
82
153
  const config: Record<string, unknown> = {}
83
154
  if (opts.params) config.params = opts.params
84
155
  if (opts.signal) config.signal = opts.signal
85
156
  if (opts.responseType === 'blob') config.responseType = 'blob'
157
+ const timeout = normalizeTimeout(opts.timeout, maxTimeoutMs)
158
+ if (timeout !== undefined) config.timeout = timeout
159
+ if (opts.freshness === 'network') config[HOST_FRESHNESS_KEY] = 'network'
160
+ const headers = sanitizeRemoteHeaders(opts.headers)
161
+ if (headers) config.headers = headers
86
162
  return config
87
163
  }
88
164
 
@@ -122,7 +198,7 @@ async function bodyOf<T>(p: Promise<{ data: unknown }>, opts?: HostApiRequestOpt
122
198
  export function createHostApi(client: ApiClient, options: CreateHostApiOptions = {}): HostApi {
123
199
  const capabilityPath = options.capabilityPath ?? '/capabilities/query'
124
200
  const withConfig = <A extends unknown[]>(args: A, opts?: HostApiRequestOptions) => {
125
- const config = toConfig(opts)
201
+ const config = toConfig(opts, options.maxTimeoutMs)
126
202
  return config ? ([...args, config] as unknown[]) : (args as unknown[])
127
203
  }
128
204
  const patch = (client as ApiClient & {
@@ -131,7 +207,9 @@ export function createHostApi(client: ApiClient, options: CreateHostApiOptions =
131
207
  return Object.freeze({
132
208
  get: <T,>(path: string, opts?: HostApiRequestOptions) => {
133
209
  const args = withConfig([path], opts) as [string, { params?: Record<string, unknown> }?]
134
- const batch = options.batchGets && opts?.responseType !== 'blob'
210
+ // A GET with per-call headers cannot share a POST /q: it goes on its own.
211
+ const batch = options.batchGets && opts?.responseType !== 'blob' && !sanitizeRemoteHeaders(opts?.headers) &&
212
+ opts?.timeout === undefined && opts?.freshness !== 'network'
135
213
  return bodyOf<T>(batch ? batchGet(client, ...args) : client.get(...args), opts)
136
214
  },
137
215
  post: <T,>(path: string, body?: unknown, opts?: HostApiRequestOptions) =>